Gmail MCP

Package (npm 1.0.0)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "mcp-google-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GOOGLE_GMAIL_CLIENT_ID": "<YOUR_VALUE>",
        "GOOGLE_GMAIL_CLIENT_SECRET": "<YOUR_VALUE>",
        "GOOGLE_GMAIL_REFRESH_TOKEN": "<YOUR_VALUE>",
        "GOOGLE_GMAIL_ACCESS_TOKEN": "<YOUR_VALUE>",
        "GOOGLE_GMAIL_OAUTH_PORT": "<YOUR_VALUE>",
        "GOOGLE_GMAIL_API_BASE": "<YOUR_VALUE>",
        "GOOGLE_GMAIL_TIMEOUT_MS": "<YOUR_VALUE>",
        "GOOGLE_GMAIL_MAX_RETRIES": "<YOUR_VALUE>"
      }
    }
  }
}

• 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).