gmail-mcp
Allows interacting with Gmail accounts, providing tools for reading, searching, labeling, and drafting emails, as well as retrieving attachments via signed download links.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
gmail-mcp
Remote MCP server on Cloudflare Workers exposing multiple Gmail accounts to Claude through one connector. Tool names, descriptions, and response shapes replicate Anthropic's built-in Gmail connector; the additions are a required account parameter on every tool (plus account: "all" fan-out on search_threads) and get_message_attachment, which the built-in connector does not expose. That tool returns a short-lived signed download link rather than attachment content, so files reach disk without passing through the model's context.
Architecture
/mcp: Streamable HTTP MCP endpoint. Two auth paths: MCP OAuth (what claude.ai uses; dynamic client registration + PKCE viaworkers-oauth-provider, with the/authorizeapproval page gated bySETUP_SECRET) or a static bearer secret (MCP_SECRET) for CLI clients and tests./attachment/<hmac>?...: serves one attachment's raw bytes.get_message_attachmentmints these links, signing account, message id, attachment id and a 10-minute expiry withMCP_SECRET. The link carries its own authorization so a plaincurl -oworks, and within its window it unlocks that one attachment and nothing else. The signature sits in the path, not a query param, because agent hosts such as OpenClaw mask secret-looking query params before the model sees the link./connect/<alias>?key=<SETUP_SECRET>: browser route that runs the Google OAuth flow for one account and stores its refresh token in KV./oauth/callback: Google OAuth redirect target.Tokens live in the
GMAIL_KVnamespace (refresh:<alias>plus a short-livedaccess:<alias>cache). Scope isgmail.modify: read, search, labels, drafts; no send.Requires a Workers paid plan:
search_threadsandlist_draftsmake one Gmail request per result, so a largepageSize(oraccount: "all") exceeds the free plan's 50-subrequest cap.
Related MCP server: gmail-mcp
Configuration
ACCOUNTSvar inwrangler.jsonc: comma-separated account aliases. Rerunnpx wrangler deployafter changing it.Secrets (set with
npx wrangler secret put <NAME>):MCP_SECRET: bearer token Claude sends; anyone holding it can read the connected mailboxes.SETUP_SECRET: gates the/connectroutes.GOOGLE_CLIENT_ID_<ALIAS>/GOOGLE_CLIENT_SECRET_<ALIAS>per account, alias uppercased (e.g.GOOGLE_CLIENT_ID_CANDIX).
Per-account Google setup (~10 min, once per Workspace org)
Go to https://console.cloud.google.com and create a project inside that Workspace org (top-left project picker > New project).
APIs & Services > Library > search "Gmail API" > Enable.
APIs & Services > OAuth consent screen: User type Internal (no verification, refresh tokens do not expire), fill in the app name and contact email.
APIs & Services > Credentials > Create credentials > OAuth client ID > Application type Web application. Add the authorized redirect URI:
https://gmail-mcp.<your-subdomain>.workers.dev/oauth/callback.Copy the client ID and secret into Worker secrets:
npx wrangler secret put GOOGLE_CLIENT_ID_<ALIAS> npx wrangler secret put GOOGLE_CLIENT_SECRET_<ALIAS>Visit
https://gmail-mcp.<your-subdomain>.workers.dev/connect/<alias>?key=<SETUP_SECRET>in a browser while signed in to that Google account, and approve.
Re-run step 6 anytime to reconnect (e.g. after revoking access).
Connect to Claude
Settings > Connectors > Add custom connector:
URL:
https://gmail-mcp.<your-subdomain>.workers.dev/mcpLeave the OAuth client ID/secret fields empty (Claude registers itself dynamically).
Click Add, then Connect: an approval page opens; paste
SETUP_SECRETand approve.
The connector then works on claude.ai web, mobile, desktop, and Claude Code.
Rotating the bearer secret
npx wrangler secret put MCP_SECRETThen update the Authorization header in the Claude connector settings.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
Hosted BigQuery MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Cloudflare Workers MCP server: ai-model-router
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Gmail MCP server running on Cloudflare Workers that enables reading, searching, labeling, drafting, sending, and managing Gmail messages, including fetching raw attachment bytes, with per-user OAuth authorization.1-
- AlicenseNot gradedqualityNot gradedmaintenanceAn MCP server that connects Gmail to AI assistants, enabling search, read, send, reply-all, forward, attachment handling, and draft management across multiple Google accounts, deployable on your own Cloudflare Worker.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceDeployable MCP server on Cloudflare Workers that connects Gmail to AI assistants, enabling search, read, send, reply-all, forward, attachment handling, and label/thread management across multiple Google accounts simultaneously.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceA Cloudflare Workers-based MCP server that connects Gmail to AI assistants, enabling search, read, send, reply-all, forward, and management of messages, drafts, labels, and threads across multiple Google accounts simultaneously.MIT