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: gmail-mcp

Tools

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 setup

The 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.

1. Create a project. Open projectcreate, name it multi-google-mcp, click Create, then Select project in the notification.

2. 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.

3. 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.

4. Add the two links Google requires before publishing. Open Branding and fill in, then Save:

   • Application home page: https://multi-google-mcp-tau.vercel.app

   • Application privacy policy link: https://multi-google-mcp-tau.vercel.app/privacy

   • Authorized domains, Add domain: multi-google-mcp-tau.vercel.app

5. 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.

6. 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 check

From source

git clone https://github.com/taimiyanis/multi-google-mcp.git
cd multi-google-mcp && npm install && npm run setup

FAQ

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-triage

Then remove the app's access at https://myaccount.google.com/permissions.

License

MIT