MCP.so
Sign In

Gmail MCP Server

@Quantum-369

Basic information

Category

Communication

License

Apache-2.0

Transports

stdio

Author

Quantum-369

About Gmail MCP Server

A model context protocol server for your Gmail

Gmail MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Gmail-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@Quantum-369/Gmail-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Gmail MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Gmail MCP Server?

Gmail MCP Server is a Gmail integration server built using the MCP (Message Control Protocol) framework. It provides a programmatic interface to read, send, and manage emails, supporting multiple Gmail accounts.

How to use Gmail MCP Server?

Install via Smithery with npx -y @smithery/cli install @Quantum-369/Gmail-mcp-server --client claude, or clone the repository and run pip install . after setting up a Python virtual environment. You must have a Google Cloud Project with Gmail API enabled and OAuth credentials. Start the server with python gmail_server.py.

Key features of Gmail MCP Server

  • Read emails from multiple Gmail accounts
  • Send emails with attachments
  • Search emails with advanced query options
  • Download email attachments
  • Handle email conversations and threads
  • Real-time email monitoring
  • Support for multiple Gmail accounts

Use cases of Gmail MCP Server

  • Automate email sending and receiving
  • Search and filter emails programmatically
  • Download attachments from emails
  • Monitor email inbox for new messages
  • Integrate Gmail into custom workflows

Frequently asked questions

1

What are the prerequisites for using Gmail MCP Server?

Python 3.12 or higher, a Google Cloud Project with Gmail API enabled, and OAuth 2.0 Client ID credentials.

2

How do I set up authentication?

Place your downloaded `client_secret.json` in the project root, then run `python gmail_token_creator.py` and follow the authorization URL to generate a token stored in `token_files/`.

3

Can I use multiple Gmail accounts?

Yes, repeat the token creation process for each account and specify the email identifier when using tools.

4

How do I run the server with Docker?

Build the image with `docker build -t gmail-mcp-server .` and run with volume mounts for `client_secret.json` and `token_files`.

5

Where are logs stored?

Logs are written to `gmail_mcp.log` with both file and console logging enabled.

Comments

More Communication MCP servers