Gmail MCP Server
Read emails, search inboxes, draft messages, and manage labels. Email organization and smart responses.
- Maintained by
- Hosting
- Hosted by the vendor
- Authentication
- OAuth sign-in
- Last checked
Google hosts a Gmail MCP endpoint (Google OAuth); Gmail is also covered by Google's open-source Workspace server, packaged as a Gemini CLI extension.
How to connect the Gmail MCP server
Pick your AI client and paste the snippet. New to this? Our guide to how MCP clients and servers fit together explains what each piece does.
Claude Code
claude mcp add --transport http gmail https://gmailmcp.googleapis.com/mcp/v1Then run /mcp inside Claude Code and choose Authenticate to sign in.
Full Claude Code setup guide →Claude Desktop and claude.ai
Name: Gmail
Remote MCP server URL: https://gmailmcp.googleapis.com/mcp/v1Custom connectors need a Pro, Max, Team or Enterprise plan. On Team and Enterprise an owner adds them in admin settings.
Full Claude Desktop setup guide →Cursor
{
"mcpServers": {
"gmail": {
"url": "https://gmailmcp.googleapis.com/mcp/v1"
}
}
}VS Code
{
"servers": {
"gmail": {
"type": "http",
"url": "https://gmailmcp.googleapis.com/mcp/v1"
}
}
}ChatGPT
Business, Enterprise and Edu plans (and Pro, read-only) can add this endpoint as an app in developer mode. ChatGPT setup guide →
Frequently asked questions
What is the Gmail MCP server?
It is a Model Context Protocol (MCP) server — a small piece of software that gives AI assistants like Claude a secure, governed connection to Gmail. Read emails, search inboxes, draft messages, and manage labels. Email organization and smart responses.
Is there an official Gmail MCP server?
Yes. The Gmail MCP server is an official integration, maintained by the vendor or the Model Context Protocol project, which makes it the safest default for business use. It is maintained by Google.
Is the Gmail MCP server hosted, or do I run it myself?
It is hosted. Gmail runs the endpoint at https://gmailmcp.googleapis.com/mcp/v1, so there is nothing to install: you add the URL to your AI client and sign in with your Gmail account.
Do I need an API key for the Gmail MCP server?
No API key is needed for the hosted server. You sign in through Gmail's own OAuth screen, and the assistant only gets the access your account has.
What can an AI assistant actually do with Gmail?
Through this server an assistant can work with email, search, labels, attachments — reading from and acting on Gmail directly instead of you copy-pasting between windows. What you allow it to do is controlled by the permissions you grant.
How do I set this up for my business?
The setup section above has copy-paste config for Claude Code, Claude Desktop, Cursor and VS Code. Once it is running against real systems, the question becomes what catches it when it acts wrongly, which is what Crox's Safety Diagnostic looks at.
New to MCP? Start with our plain-English guide to the Model Context Protocol or see how to connect AI to your business tools without writing code .
Already running this in production?
An agent with a live connection to your tools is a model that can act. Crox looks at what catches it when it acts wrongly: the layers around it, who can stop it, and where a near miss gets reported. Two days, one team, one model.