PluginBench
MCP Server
Active
MIT

Gmail MCP MCP Server

io.github.A1-x-Tech/mcp-google-gmail

RepositoryRegistry
How to choose

What this kind of tool is for

  • Draft, send, or triage messages and email from inside your agent.
  • Pipe notifications from a build or alert into your team channel automatically.
  • Summarize a busy channel thread into the handful of points that matter.

How to compare servers like this

Channel coverage:
Check the specific app (email, chat, notifications) and whether it reads as well as writes.
Scope of access:
Messages are sensitive; review what the tool can see before connecting an account.
Rate behavior:
Bulk-sending tools should respect provider limits — avoid anything that floods.
Maintenance signal:
APIs in this space change often; recent updates are a strong signal.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the Gmail MCP MCP server?

MCP server for the Gmail API: search, read and send email, manage drafts, labels and the trash.

How to install Gmail MCP

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • GOOGLE_GMAIL_CLIENT_ID

    Google OAuth2 client id (refresh-token flow).

  • GOOGLE_GMAIL_CLIENT_SECRET
    secret

    Google OAuth2 client secret (refresh-token flow). Treat it as a secret.

  • GOOGLE_GMAIL_REFRESH_TOKEN
    secret

    Google OAuth2 refresh token, exchanged for access tokens automatically. Treat it as a secret.

  • GOOGLE_GMAIL_ACCESS_TOKEN
    secret

    Static OAuth2 access token (~1h lifetime) — alternative to the refresh-token trio, mostly for testing.

  • GOOGLE_GMAIL_OAUTH_PORT

    Fixed port for the loopback listener of the in-chat login (127.0.0.1 + PKCE). Set it when the client runs over SSH port forwarding; otherwise a free port is picked per login.

  • GOOGLE_GMAIL_API_BASE

    API root override.

  • GOOGLE_GMAIL_TIMEOUT_MS

    Per-request timeout in milliseconds.

  • GOOGLE_GMAIL_MAX_RETRIES

    Retries on transient errors (429 always; 5xx/network for reads).

~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "mcpServers": {
    "mcp-google-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-gmail"
      ],
      "env": {
        "GOOGLE_GMAIL_CLIENT_ID": "<YOUR_GOOGLE_GMAIL_CLIENT_ID>",
        "GOOGLE_GMAIL_CLIENT_SECRET": "<YOUR_GOOGLE_GMAIL_CLIENT_SECRET>",
        "GOOGLE_GMAIL_REFRESH_TOKEN": "<YOUR_GOOGLE_GMAIL_REFRESH_TOKEN>",
        "GOOGLE_GMAIL_ACCESS_TOKEN": "<YOUR_GOOGLE_GMAIL_ACCESS_TOKEN>",
        "GOOGLE_GMAIL_OAUTH_PORT": "<YOUR_GOOGLE_GMAIL_OAUTH_PORT>",
        "GOOGLE_GMAIL_API_BASE": "<YOUR_GOOGLE_GMAIL_API_BASE>",
        "GOOGLE_GMAIL_TIMEOUT_MS": "<YOUR_GOOGLE_GMAIL_TIMEOUT_MS>",
        "GOOGLE_GMAIL_MAX_RETRIES": "<YOUR_GOOGLE_GMAIL_MAX_RETRIES>"
      }
    }
  }
}

Related MCP servers

MCP server for Google Merchant Center (Merchant API v1): products, promotions, reports, issues.

0
TypeScript
MIT
View repository →

MCP server for the Google Search Console API: search analytics, sitemaps, URL inspection, sites.

0
TypeScript
MIT
View repository →

MCP server for the Google Sheets API: read and write ranges, sheets, formatting, charts, sharing.

1
TypeScript
MIT
View repository →

MCP server for the Google Slides API: presentations, slides, text, shapes, images and tables.

1
TypeScript
MIT
View repository →

MCP server for the Google Tag Manager API v2: containers, workspaces, tags, triggers, publishing.

0
TypeScript
MIT
View repository →

MCP server for the Google Tasks API: task lists, subtasks, due dates, complete and move tasks.

View repository →