Multi Google MCP

Multi-account Google MCP server for Claude Code — Gmail, Drive, Calendar, Sheets, Docs, Contacts, Search Console. 83 tools with OAuth2 multi-account switching.

GitHub
7

Documentation

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.

npm

  • 🧰 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

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