Multi Gmail MCP server
io.github.gx-55/multi-gmail-mcp·v1.0.1·19 starsManage multiple Gmail accounts in Claude Desktop — search, send, reply, draft, and organize.
19 stars75 downloads/wk
Reviews
Write oneNobody has reviewed Multi Gmail yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Multi Gmail tools (15, 7 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_labelAdd one or more labels to an email.
archive_emailwrite actionArchive an email by removing it from the inbox.
complete_authFinish OAuth2 authentication after the user has opened the URL from initiate_auth
create_draftwrite actionSave an email as a draft without sending.
get_emailwrite actionFetch the full content of an email by ID.
initiate_authStart OAuth2 authentication for a Gmail account.
list_accountsList all authenticated Gmail accounts.
list_labelsList all Gmail labels for an account.
mark_as_readMark an email as read.
mark_as_unreadMark an email as unread.
remove_accountwrite actionRemove a Gmail account and its stored credentials.
remove_labelwrite actionRemove one or more labels from an email.
reply_to_emailwrite actionReply to an existing email, preserving thread context.
search_emailsSearch emails using Gmail search syntax (e.g. "from:foo is:unread").
send_emailwrite actionSend an email from a Gmail account.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan10 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 45 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Multi Gmail compares
Against every graded Email MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 62% of 916 Email servers
- Tools
- 15
- the typical Email server has 7
- Tools that change things
- 47%
- typical: 25%. Fewer write tools means less an agent can break
- GitHub stars
- 19
- more than 91% of 493 Email servers
- Downloads a week
- 75
- more than 51% of 235 Email servers with a package
What its tools let an agent do: 5 read · 2 create · 3 change · 3 delete · 2 send or post
Install Multi Gmail in Claude Code, Cursor or VS Code
Runs npx -y multi-gmail-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add multi-gmail-mcp -- npx -y multi-gmail-mcp
What the publisher says
From the Multi Gmail repository's README, as published. We do not edit it. Read it on GitHub
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.
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-mcpThis 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.
- Go to console.cloud.google.com → create a project
- Enable the Gmail API (APIs & Services → Library)
- Configure the OAuth consent screen — External, add your Gmail addresses as test users
- Add scopes: gmail.readonly, gmail.send, gmail.modify, gmail.labels
- Create a Desktop app OAuth credential → download the JSON
- Save it to ~/.gmail-mcp-oauth.json
Alternatively, set environment variables in the Claude Desktop config (see below).
Authenticating Gmail Accounts
# Add accounts (opens browser for Google sign-in)
gmail-mcp-cli add personal@gmail.com
gmail-mcp-cli add work@company.com
# List authenticated accounts
gmail-mcp-cli list
# Remove an account
gmail-mcp-cli remove work@company.comTokens are saved to ~/.gmail-mcp-tokens.db and refreshed automatically.
Claude Desktop Configuration
Edit ~/Library/Application Support/Claude/claudedesktopconfig.json:
{
"mcpServers": {
"multi-gmail": {
"command": "gmail-mcp"
}
}
}If you prefer environment variables over ~/.gmail-mcp-oauth.json:
{
"mcpServers": {
"multi-gmail": {
"command": "gmail-mcp",
"env": {
"GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "your-client-secret"
}
}
}
}Restart Claude Desktop after saving. Click the hammer icon to confirm 19 tools are loaded.
Available Tools
Account Management
Reading Email
Writing Email
Organization
Example Prompts
List all my authenticated Gmail accounts.Search my work@company.com inbox for unread emails from this week.Reply to that email from my personal account saying I'll be there Saturday.Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Multi Gmail: common questions
- Is Multi Gmail MCP server safe?
- Mostly: it is graded B (78/100). Read the Multi Gmail safety report
- How do I install Multi Gmail?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Multi Gmail need an API key?
- Yes. The registry entry asks for
GOOGLE_CLIENT_SECRET. - Is Multi Gmail maintained?
- The last commit was 83 days ago (2026-08-13). The latest release is v1.0.1.
- What can I use instead of Multi Gmail?
- Servers from other publishers that do the same job: Google Workspace MCP server, Imap MCP server and Fluxmail MCP server. Compare all Multi Gmail alternatives.
- How does Multi Gmail compare with other Email MCP servers?
- safety score 78/100 (higher than 62% of 916 Email servers); tools 15 (the typical Email server has 7); tools that change things 47% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Multi Gmail
Same job from other publishers: the closest match first, then the best rated.
- Google WorkspaceGive AI agents access to Gmail, Calendar, Drive, and more — multi-account, manifest-drivennot reviewedEstablishedA
- ImapIMAP/SMTP MCP server to search, read, organize, send, reply & forward email for AI assistantsnot reviewedEstablishedA
- FluxmailRead, search, draft, send, and organize email through Gmail, Outlook, and IMAP/SMTP mailboxes.not reviewedGrowingB
- Agent EmailLocal email connectivity for AI agents — read, draft, send, and organize Outlook mail via MCPnot reviewedGrowingA
- Microsoft 365 MailMicrosoft 365 Outlook mail via Graph: read, search, send, reply, forward, draft, move, delete.not reviewedGrowingA