Skip to content
Claude Code

Gmail MCP for Claude Code

io.github.a1-x-tech/mcp-google-gmail

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

client:Claude Code transport:stdio runtime:npm

Install Gmail MCP in Claude Code

run in your project directory

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

claude mcp add mcp-google-gmail -e GOOGLE_GMAIL_CLIENT_ID=<GOOGLE_GMAIL_CLIENT_ID> -e GOOGLE_GMAIL_CLIENT_SECRET=<GOOGLE_GMAIL_CLIENT_SECRET> -e GOOGLE_GMAIL_REFRESH_TOKEN=<GOOGLE_GMAIL_REFRESH_TOKEN> -e GOOGLE_GMAIL_ACCESS_TOKEN=<GOOGLE_GMAIL_ACCESS_TOKEN> -e GOOGLE_GMAIL_OAUTH_PORT=<GOOGLE_GMAIL_OAUTH_PORT> -e GOOGLE_GMAIL_API_BASE=<GOOGLE_GMAIL_API_BASE> -e GOOGLE_GMAIL_TIMEOUT_MS=<GOOGLE_GMAIL_TIMEOUT_MS> -e GOOGLE_GMAIL_MAX_RETRIES=<GOOGLE_GMAIL_MAX_RETRIES> -- npx -y mcp-google-gmail

Adds it for this project only. Append --scope user to make it available everywhere. Claude Code docs

Gmail MCP in other clients