Gmail MCP Server

by domdomeggio.github.domdomegg/gmail-mcpv2.4.0

Allow AI systems to read, send, archive, and manage emails via Gmail.

11Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active31d ago

Install Gmail MCP server

claude mcp add gmail-domdomegg -e GOOGLE_ACCESS_TOKEN='<google-access-token>' -- npx -y gmail-mcp

{
  "mcpServers": {
    "gmail-domdomegg": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp"
      ],
      "env": {
        "GOOGLE_ACCESS_TOKEN": "<google-access-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "gmail-domdomegg": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp"
      ],
      "env": {
        "GOOGLE_ACCESS_TOKEN": "<google-access-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "gmail-domdomegg": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp"
      ],
      "env": {
        "GOOGLE_ACCESS_TOKEN": "<google-access-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "gmail-domdomegg": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp"
      ],
      "env": {
        "GOOGLE_ACCESS_TOKEN": "<google-access-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GOOGLE_ACCESS_TOKEN	yes	yes	Google OAuth access token with Gmail scopes.
MCP_TRANSPORT	yes	—	Transport type.
GOOGLE_CLIENT_ID	yes	—	Google OAuth client ID.
GOOGLE_CLIENT_SECRET	yes	yes	Google OAuth client secret.

Freshness

Active — last maintenance signal 31d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-09 · 31d ago · GitHub
Latest release
2026-07-27 · 3mo ago · GitHub · v2.4.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-27 · 3mo ago · official registry · v2.4.0

FAQ

›How do I install the Gmail MCP server in Claude Code?

Run: claude mcp add gmail-domdomegg -e GOOGLE_ACCESS_TOKEN='<google-access-token>' -- npx -y gmail-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Gmail require an API key?

Yes. It expects GOOGLE_ACCESS_TOKEN, MCP_TRANSPORT, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, of which 2 are secrets.

›Can I use Gmail as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Gmail in the official MCP registry?

Yes, as io.github.domdomegg/gmail-mcp.