Claude Gmail MCP Server

A super tiny Gmail MCP server for Claude Code. Lets Claude send, search, and read Gmail on your behalf.

Local serverstdioPython

What is the Claude Gmail MCP Server?

A super tiny Gmail MCP server for Claude Code. Lets Claude send, search, and read Gmail on your behalf.

Configuration and credentials

  • uv installed - One of: - A Google Cloud OAuth client (Desktop app) — for the API backend, OR - A Gmail App Password — for the SMTP/IMAP backend

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Claude Gmail MCP Server

{
  "mcpServers": {
    "claude-gmail": {
      "command": "uvx",
      "args": ["claude-gmail-mcp"],
      "env": {
        "GMAIL_TOKEN_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • uv installed - One of: - A Google Cloud OAuth client (Desktop app) — for the API backend, OR - A Gmail App Password — for the SMTP/IMAP backend
VariableDescriptionRequired
GMAIL_TOKEN_PATHCredential the server authenticates with.Yes

Frequently asked questions

A super tiny Gmail MCP server for Claude Code. Lets Claude send, search, and read Gmail on your behalf. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.