Gmail MCP
Read, search, draft and send Gmail from an agent
BestMCPTools
Gmail MCP
bestmcptools.org
Last verified: September 20, 2026
Maintenance status
ArchivedThe maintainers have archived this repository (read-only, no longer updated).
How to Install Gmail MCP
$npx @gongrzhe/server-gmail-autoauth-mcpRequires Claude Desktop, Cursor, Windsurf, or another MCP-compatible client.
Setup by client
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"gmail-mcp": {
"command": "npx",
"args": [
"@gongrzhe/server-gmail-autoauth-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"gmail-mcp": {
"command": "npx",
"args": [
"@gongrzhe/server-gmail-autoauth-mcp"
]
}
}
}VS Code (.vscode/mcp.json)
{
"servers": {
"gmail-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"@gongrzhe/server-gmail-autoauth-mcp"
]
}
}
}Claude Code (terminal)
claude mcp add gmail-mcp -- npx @gongrzhe/server-gmail-autoauth-mcpAdd any API keys or environment variables the server's README lists.
About Gmail MCP
A widely used community Gmail MCP server that connects an agent to a Google mailbox over OAuth, exposing search, thread reading, labelling, drafting and optional sending as tools. For attachments and documents, the Google Drive MCP setup covers Docs, Sheets and files.
Gmail MCP is a Productivity MCP server designed for individual operators, founders, and small teams. It enables letting AI assistants act inside your notes, tasks, and calendar by exposing CRUD operations on your productivity stack as MCP tools. Key capabilities include task, note, and calendar reads, create, update, and complete operations, workspace and project scoping, and structured tool calls that work cleanly inside an LLM context. It integrates with Notion, Linear, Todoist, Google Calendar, Obsidian, Asana, and ClickUp, and is best suited for individual operators, founders, and small teams who need daily planning and triage.
Key Features
- gmail
- Task, note, and calendar reads
- Create, update, and complete operations
- Workspace and project scoping
Pricing
Open Source: from Free
Pros & Cons
Pros
- Removes most tab-switching from daily admin
- Keeps work in your existing system of record
- Composable with other MCP servers
Cons
- Tightly coupled to the host platform's API
- Bulk operations need careful scoping
- Cross-app coordination still requires orchestration
Best For
- Daily planning and triage
- Capturing tasks from chat
- Calendar coordination
- Personal knowledge management
Our Take on Gmail MCP
The most widely used Gmail bridge for agents. Auto-auth setup is genuinely easy, but it hands an agent real mailbox access. Use a dedicated account rather than your primary one.