google-mcp

Multi-account wrapper for the Google Drive MCP Server. Adds account management, an interactive setup wizard, and Claude-assisted browser automation.

What This Does

• Multi-account support — run separate MCP server instances for different Google accounts, each with isolated credentials and tokens
• Setup wizard — walks through GCP project creation, API enablement, and OAuth configuration step by step
• Claude-assisted setup — automates browser steps using Claude Code + Chrome extension
• Account management — list accounts, track setup progress, resume from failures

The actual MCP tools (Drive, Docs, Sheets, Slides, Calendar) come from @piotr-agier/google-drive-mcp — this project wraps it.

Quick Start

git clone <repo-url>
cd google-mcp
npm install
npm run build

# Set up a Google account
npm run setup

# Add to Claude Code
claude mcp add -s user google-user-example node /path/to/dist/index.js -- --account [email protected]

Setup

Interactive Wizard

npm run setup

The wizard walks through:

1. Account email (for credential namespacing)
2. Mode selection (manual or Claude-assisted)
3. GCP project creation
4. API enablement (Drive, Docs, Sheets, Slides, Calendar)
5. OAuth consent screen (branding, audience, scopes)
6. OAuth credentials download
7. Authentication

Claude-Assisted Mode

Select "Claude-assisted" in the wizard to automate the browser steps. Requires:

• Claude Code CLI installed
• Chrome extension connected

The wizard invokes claude -p --chrome for each browser step.

CLI Flags

Pre-fill answers to skip prompts:

npm run setup -- --account [email protected] --project-id my-project --mode claude
npm run setup -- --account [email protected] --step audience --mode claude
npm run setup -- --credentials ~/Downloads/client_secret*.json --no-auth

Available flags: --account, --project-id, --credentials, --mode (manual/claude), --step, --gcloud-account, --skip-browser, --skip-gcloud, --create-project, --run-auth, --no-auth

Multiple Accounts

Each account gets its own credential directory:

~/.config/google-drive-mcp/accounts/
  user-at-example-com/
    gcp-oauth.keys.json
    tokens.json
  jane-doe-at-gmail-com/
    gcp-oauth.keys.json
    tokens.json

List Accounts

node dist/index.js accounts
node dist/index.js accounts --account [email protected]

Shows setup progress per account:

[email protected]
  mcp name: google-jane-doe-gmail
  project:  my-gcp-project
  setup:   enable-apis ✓  branding ✓  audience ✓  scopes ✓  credentials ✓  auth ·

Add to Claude Code

Each account becomes a separate MCP server with a unique name:

claude mcp add -s user google-user-example \
  node /path/to/dist/index.js -- --account [email protected]

claude mcp add -s user google-jane-doe-gmail \
  node /path/to/dist/index.js -- --account [email protected]

Authenticate

node dist/index.js auth --account [email protected]

Available Tools

See the upstream documentation for the full list of MCP tools (search, file management, Docs editing, Sheets, Slides, Calendar, etc.).

Development

npm run build          # typecheck + bundle
npm run test:unit      # run tests
npm run watch          # esbuild watch mode
npm run lint           # tsc + eslint

Architecture

This is a thin CLI wrapper (4 source files, ~1000 lines):

• src/index.ts — CLI dispatcher. For start, spawns npx @piotr-agier/google-drive-mcp with account-specific env vars.
• src/accounts.ts — Account registry, credential paths, setup step tracking
• src/auth.ts — OAuth flow via @google-cloud/local-auth
• src/setup.ts — Interactive setup wizard with step-by-step browser automation