Multi Gmail Mcp
Gives Claude direct access to the Gmail API across multiple accounts simultaneously. You get the full search syntax, thread-aware replies, draft creation, and label management without switching contexts. Useful when you're juggling personal, work, and side project inboxes and need to triage, respond, or batch organize from a single conversation. OAuth tokens live in a local SQLite database and refresh automatically. Ships with a CLI for adding accounts outside of Claude, then exposes 19 tools covering everything from search and send to archiving and marking read. If you're already using Claude Desktop for email-heavy workflows, this turns it into a multi-account client.
- GitHub stars
- 11
- tools
- 15
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Apr 27, 2026
Tools
15 toolsPublic tool metadata for what this MCP can expose to an agent.
list_accountsList all authenticated Gmail accounts
List all authenticated Gmail accounts
No parameter schema in public metadata yet.
initiate_authStart OAuth flow — returns a URL to open in browser
Start OAuth flow — returns a URL to open in browser
No parameter schema in public metadata yet.
complete_authFinalize auth after completing Google sign-in
Finalize auth after completing Google sign-in
No parameter schema in public metadata yet.
remove_accountRemove an account and its stored credentials
Remove an account and its stored credentials
No parameter schema in public metadata yet.
search_emailsSearch with Gmail syntax (`is:unread`, `from:`, `after:`, etc.)
Search with Gmail syntax (`is:unread`, `from:`, `after:`, etc.)
No parameter schema in public metadata yet.
get_emailFetch full email content by message ID
Fetch full email content by message ID
No parameter schema in public metadata yet.
send_emailSend an email (supports To, CC, BCC)
Send an email (supports To, CC, BCC)
No parameter schema in public metadata yet.
reply_to_emailReply in thread, preserving References headers
Reply in thread, preserving References headers
No parameter schema in public metadata yet.
create_draftSave an email as a draft
Save an email as a draft
No parameter schema in public metadata yet.
list_labelsList all Gmail labels for an account
List all Gmail labels for an account
No parameter schema in public metadata yet.
add_labelAdd one or more labels to a message
Add one or more labels to a message
No parameter schema in public metadata yet.
remove_labelRemove one or more labels from a message
Remove one or more labels from a message
No parameter schema in public metadata yet.
archive_emailRemove from Inbox
Remove from Inbox
No parameter schema in public metadata yet.
mark_as_readRemove the UNREAD label
Remove the UNREAD label
No parameter schema in public metadata yet.
mark_as_unreadAdd the UNREAD label
Add the UNREAD label
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
GOOGLE_CLIENT_IDGoogle OAuth2 client ID from your Google Cloud project (alternative to ~/.gmail-mcp-oauth.json)
GOOGLE_CLIENT_SECRETsecretGoogle OAuth2 client secret from your Google Cloud project (alternative to ~/.gmail-mcp-oauth.json)
Readme
multi-gmail-mcp
A Model Context Protocol (MCP) server that lets Claude Desktop manage multiple Gmail accounts simultaneously. Listed on the official Anthropic MCP registry and published on npm.
demo
Features
- Connect unlimited Gmail accounts — personal, work, side projects
- Search any inbox using full Gmail search syntax
- Read complete emails with MIME parsing
- Send, reply in thread, and create drafts
- Organize with labels: add, remove, list, archive
- Mark as read / unread
- Tokens stored locally in
~/.gmail-mcp-tokens.db— never committed to git - Auto-refreshes OAuth tokens silently
Requirements
- Node.js >= 22.5.0
- A Google Cloud project with the Gmail API enabled
- Claude Desktop
Installation
npm install -g multi-gmail-mcp
This registers two global commands: gmail-mcp (the MCP server) and gmail-mcp-cli (account manager).
Google Cloud Setup
You only need to do this once.
Details
- Repository
- github.com/gx-55/multi-gmail-mcp
- Categories
- Communication & Messaging, Search & Web Crawling
- Package
multi-gmail-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Communication & Messaging MCP servers
View all
Microsoft Teams APImaxim-mazurok/teams-apiAI-native Microsoft Teams integration — read chats, send messages, search people9stars
Gmailmintmcp/serversA MCP server for Gmail that lets you search, read, and draft emails and replies.0stars
Telegram Notify Mcpparthjadhav/telegram-notify-mcpSend Telegram notifications from AI agents — text, photos, and documents.7stars
Samihalawa Whatsapp Go Mcpsamihalawa/whatsapp-go-mcpScan QR codes and go! No more troublesome autos or APIs! Send text messages, images, links, locati…5stars
Multi-workspace Slack MCP server with draft+confirm safety, vault auto-export, aadelaidasofia/slack-mcpMulti-workspace Slack MCP server with draft+confirm safety, vault auto-export, and triple-mode…1stars