multi-mail-mcp
Provides tools for searching and reading Gmail threads across multiple connected accounts, creating drafts in the correct account and thread, managing labels, archiving threads, and marking messages as read. Sending and deleting email are not supported.
Provides read-only access to events from every calendar across connected Google accounts, with duplicate events merged.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
multi-google-mcp
One MCP server for all your Google accounts. Claude reads mail across every account and writes drafts from the right address, finds and reads files in every Drive, creates and edits Docs and Sheets, and manages every calendar. It cannot send an email and it cannot delete anything.
Built for people who juggle a work account, a school or association account, and a personal one, and want one assistant that sees all of them.
What you can ask
"What came in today across my inboxes?"
"Summarise the thread with the venue about Thursday and draft a reply from my work address."
"Find the budget sheet in any of my Drives and tell me what changed this month."
"Read the client deck and the meeting notes, then write a one-page brief as a new Doc."
"Add these three expenses to the tracking sheet." (shown to you first if the sheet is shared)
"Block Thursday 2 to 4 pm for deep work on my work calendar."
"Who have I been waiting on for more than three days?"
With the included /mail-triage skill for Claude Code, one command sorts new mail into
needs you / FYI / noise, finds the replies you owe and the answers you are waiting for, and leaves
drafts written in your own voice in each account.
Related MCP server: mail-mcp
Tools
Area | Tool | Does |
Accounts |
| The connected accounts |
| Gmail search syntax, across all accounts or one | |
| A whole thread as plain text, with attachment names | |
| A reply in the thread, or a new email, saved as a draft in the chosen account | |
| Read and apply labels (missing labels are created) | |
| Archive and read state, reversible | |
Calendar |
| Events from every calendar of every account, duplicates merged |
| Add or change events, optionally with a Meet link | |
Drive |
| Names and contents, in My Drive, shared with me and shared drives, all accounts |
| Docs as Markdown, Sheets tab by tab, Slides with speaker notes; PDFs and images saved locally for Claude to open | |
Docs |
| New Doc from Markdown; append or find-and-replace |
Sheets |
| New Sheet from rows (formulas work); append or overwrite |
Safety, by design
No send, no delete. Those tools do not exist. Every email goes out from your own Gmail, after you read it. No file, event, label or message can be deleted.
Shared files wait for you. Editing a Doc or Sheet that other people can see is refused until you approve that exact change. Files you alone own are edited directly.
Guests wait for you. An event with guests notifies them, so creating or changing one is refused until you approve that exact event and guest list.
Mail sorting is reversible. Archived mail stays in All Mail and returns on any reply.
Your keys, your machine. You create your own Google login key. Tokens are stored in
~/.config/multi-google-mcp/(readable by your user only). Nothing goes through a third-party server.
Note: the permissions are broad (Gmail modify, full Drive, Calendar events), so Google's consent screen lists more than the server does. The safety rules above are enforced in the code, not left to the assistant.
Setup
Requirements: Node.js 20+, a Google account, and an MCP client (Claude Code, Claude Desktop, Cursor).
npx multi-google-mcp setupThe wizard walks you through three parts and waits for you at each step.
1. Your own Google login key (one time, about 10 minutes)
Each user makes their own key, so your data never goes through anyone else.
Create a project. Open projectcreate, name it
multi-google-mcp, click Create, then Select project in the notification.Turn on the six APIs with one link: enable Gmail, Calendar, Drive, Docs, Sheets and Slides. Check that the top bar shows your project, then Next and Enable.
Set up the sign-in screen. Open Google Auth Platform, click Get started. App name: anything without "Google", "Gmail" or "Inbox". Support email: yours. Audience: External. Contact email: yours. Tick the policy box, Continue, Create.
Add the two links Google requires before publishing. Open Branding and fill in, then Save:
Application home page:
https://multi-google-mcp-tau.vercel.appApplication privacy policy link:
https://multi-google-mcp-tau.vercel.app/privacyAuthorized domains, Add domain:
multi-google-mcp-tau.vercel.app
Publish the app. Open Audience, click Publish app, then Confirm. Ignore the note about verification: the app is only for you. Without publishing, Google signs you out every 7 days.
Create the login key. Open Create client, choose Desktop app, click Create, then Download JSON. Google shows the secret only once. The wizard finds the downloaded file by itself.
2. Your accounts
Type each address; a browser tab opens for each. Google warns that it has not verified the app. It is your own app: click Advanced, then Go to (your app name), and tick every box.
The wizard then checks Gmail, Drive and Calendar on each account and tells you how to fix anything that fails.
3. Claude
It registers the server in Claude Code for all your projects and installs the /mail-triage skill.
Other clients (Claude Desktop, Cursor): command npx, arguments -y multi-google-mcp mcp.
Manage accounts
npx multi-google-mcp add you@company.com
npx multi-google-mcp remove you@company.com
npx multi-google-mcp accounts
npx multi-google-mcp checkFrom source
git clone https://github.com/taimiyanis/multi-google-mcp.git
cd multi-google-mcp && npm install && npm run setupFAQ
Why do I need my own Google project? Reading Gmail and Drive are restricted permissions. An app shared by many people needs a paid yearly security audit from Google. A private app used only by you does not, and your data never touches anyone else's server.
"Access blocked: admin_policy_enforced". That organisation's Google admin blocks outside apps. Only the admin can allow it.
Can it read Word, Excel or PowerPoint files? Not yet: it reads Google Docs, Sheets and Slides, text files, PDFs and images. Open an Office file in Google Drive and save it as a Google file first.
Does it work with Outlook or iCloud? No. Google accounts only (Gmail and Google Workspace).
How is this different from other Google MCP servers? Most connect one account. This one is built around running several at once: every search covers every account, results are merged, drafts and files land in the account you choose, and the guardrails for shared files and guests are in the code.
Uninstall
claude mcp remove multi-google -s user
rm -rf ~/.config/multi-google-mcp ~/.claude/skills/mail-triageThen remove the app's access at https://myaccount.google.com/permissions.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Multiple Gmail accounts, editable Google Sheets & Docs for AI agents. Deny-by-default access rules.
Search and triage all your mailboxes; draft replies and campaigns; send only as you allow.
Permissioned access to Gmail, Drive and Calendar via the user's own Google account
Give AI agents their own email inboxes: list, read and send mail via scoped, revocable OAuth grants.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to read and draft emails across multiple Gmail accounts at once, with strict safeguards that prevent sending, deleting, or modifying mailbox settings.AGPL 3.0
- AlicenseNot gradedqualityBmaintenanceGives AI assistants read-only access to several IMAP mailboxes, letting them list accounts, search, read messages and read threads across accounts without marking anything as read. Drafting and archiving are opt-in, per-account capabilities that never send or delete mail.MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to search, read, draft, and send email over IMAP/SMTP across multiple mailboxes, without any ability to delete, move, or expunge messages.959 npmMIT
- AlicenseAqualityCmaintenanceEnables Claude to read and label Gmail messages, create and update email drafts, and work with Google Calendar events without any capability to send mail.14MIT