Gmail MCP Server

Gmail MCP Server with on-demand authentication for SIYA/Claude Desktop. Complete Gmail integration with multi-user support and OAuth2 security.

Node.jsstdio

context tax

pending

security

pending

cold start

pending

freshness

pending

Our reading of Gmail, from the data

Gmail is a email MCP server.

We haven't measured its tool list yet, so its token cost is unknown.

It runs locally on your machine over stdio.

Install Gmail MCP server

claude mcp add gmail-mcp-server -- npx -y gmail-mcp-server

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp-server"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp-server"
      ]
    }
  }
}

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

{
  "servers": {
    "gmail-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp-server"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-mcp-server"
      ]
    }
  }
}

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

Freshness

Not enough public signals yet to judge maintenance.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
no data · official registry

How it compares in Email

Against the most-starred email servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
Gmail (this)	—	—	not measured	—	local
Inbox Zero	12,649	—	not measured	Active	hosted
Useplunk	5,524	—	not measured	—	local
Google Workspace	3,370	—	not measured	Active	—
OpenOSINT	1,776	—	not measured	Active	local
emailmd	1,382	3	954	Active	local + hosted

All email MCP servers

FAQ

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

Run: claude mcp add gmail-mcp-server -- npx -y gmail-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Gmail require an API key?

No required environment variables are declared in its published metadata.

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

No hosted endpoint is published; it runs locally over stdio.

›Is Gmail in the official MCP registry?

No. It was indexed from npm.

Sources and method

Package registry (npm / PyPI): listed
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.