Google's managed Gmail MCP server lets AI agents search and read threads and messages, create drafts, and manage labels. It is part of the Google Workspace Developer Preview Program and requires enabling the MCP service in a Google Cloud project and configuring an OAuth 2.0 client.
Also available as
Connect
- 1Connect it in ChatGPT
Turn on Developer mode in ChatGPT (Settings → Security and login), open Plugins, select + and paste https://gmailmcp.googleapis.com/mcp/v1 as the MCP server URL, then sign in with OAuth. Add it to a chat from the composer's tools menu.
- 2Or add it to Codex or the API
codex mcp add gmail --url https://gmailmcp.googleapis.com/mcp/v1 codex mcp login gmailThe login command opens a browser to finish OAuth.
Configs are generated from the publisher's documented endpoint. Check their docs for plan requirements and scopes. New to this? Read the step-by-step tutorial.
Tools 11
search_threadsget_threadget_messagecreate_draftlist_draftslist_labelscreate_labellabel_threadunlabel_threadlabel_messageunlabel_messageThings to ask
- “Search my Gmail for invoices from last month”
- “Draft a reply to the latest email from Sarah about the offsite”
- “Label all threads from the vendor as 'Procurement'”
- “Summarize the thread about the contract renewal”