mcp-google-multi

The most complete local Google Workspace MCP server: Gmail, Drive, Calendar, Sheets, Docs, Slides, Forms, Contacts, Tasks, Chat, Meet, Classroom, Vault, Admin and more — every OAuth-reachable Workspace API method as a tool, across multiple Google accounts at once, from Claude Code or any MCP client.

• 🧰 Exhaustive — 871 tools across 28 services + an escape hatch for anything else → COVERAGE.md

• 🔑 Multi-account — drive any number of Google accounts by alias, or fan one call out across all of them

• 🔒 Private by design — your own OAuth app, tokens encrypted at rest (AES-256-GCM), writes deny-by-default, no telemetry, no metering — it talks only to Google

Quick setup

You don't need to know anything about MCP or OAuth — five steps, all copy-paste:

1. Install Node.js 20 or newer, then install the server:

   npm install -g mcp-google-multi

2. Create your (free) Google app so the server can sign in as you — one-time, ~2 minutes: follow Google Cloud setup. You come back with a Client ID and Client Secret.

3. Create a file named .env in the folder you'll run from, and fill in your values:

   GOOGLE_CLIENT_ID=paste-your-client-id
   GOOGLE_CLIENT_SECRET=paste-your-client-secret
   # name each Google account with a short alias:
   GOOGLE_ACCOUNTS=work:you@company.com,personal:you@gmail.com
   # encryption key for stored tokens — generate one with: openssl rand -base64 32
   MASTER_KEY=paste-the-generated-key

4. Sign in each account (a browser window opens; approve the permissions):

   mcp-google-multi auth --account work
   mcp-google-multi auth --account personal

5. Connect it to Claude Code (any MCP client works the same way):

   claude mcp add google-multi -s user -- npx -y mcp-google-multi

Restart your client and the tools appear. Check everything with mcp-google-multi config check.

Go deeper: Configuration reference · What's covered · Features tour · Secrets in a vault · Upgrading from v4 · Security policy · Roadmap

Related MCP server: google-workspace-mcp

Maintainer & credits

Built and maintained by Abdelbaki Berkati — berkati.xyz · @bakissation. Read the case study →

Development is funded by IdeaCrafters (@IdeaCraftersHQ) — the studio that pays for this OSS to exist.

Thanks to contributors @obatried, @trevor-commits, and @mjreddy. The project is maintainer-led (roadmap on Milestones; bug reports welcome, feature PRs by prior agreement — see CONTRIBUTING.md). v5 is complete and in a feedback period: open an issue with bugs, pain points, or what you wish it did — it directly shapes the v6 roadmap. Security reports go to SECURITY.md, never a public issue.

License

MIT