Gmail MCP: Documentation
Updated:
Connection
Remote: https://gmailmcp.googleapis.com/mcp/v1 (JSON-RPC 2.0 over HTTPS, a single global endpoint). Auth is Google OAuth 2.0 with the required mail scopes. The service is part of the Google Workspace Developer Preview program: access isn't open to every account yet. In Claude.ai, adding it as a custom MCP connector requires a paid plan — Pro, Max, Team or Enterprise (not available on the free plan).
Tools
10 tools: create_draft, get_message, get_thread, label_message, label_thread, list_drafts, list_labels, search_threads, unlabel_message, unlabel_thread. The full parameter schema is available by calling tools/list on the endpoint after authorization.
Agent flow
"Find all emails from support this past week and draft an apology for the delay", "label every email with subject Invoice as Finance", "show today's unread threads and summarize them".
Limits
Developer Preview: the interface and toolset may change before general availability. There's no tool to send mail directly without a draft, and no bulk delete — the server is focused on drafts, search and labels.
Pricing
The MCP server itself is free under the preview program; using it as a custom connector in Claude.ai requires a paid Claude plan (Pro/Max/Team/Enterprise).