Beta — Google OAuth approval pending, by-invite access
Open Source · Local-first · Zero Config

Connect AI to Your
Google Workspace

Give Claude access to your Gmail, Drive, and Calendar. Set up in one command. Runs locally on your machine — your data never leaves your computer.

57+ Tools
3 Google Services
9 Permission Levels
MIT Open Source

Up and running in seconds

No Google Cloud project needed. Install, connect your account, done.

Terminal claude mcp add proGoogleMCP -- npx -y @procedure-tech/mcp-google
claude_desktop_config.json
{
  "mcpServers": {
    "proGoogleMCP": {
      "command": "npx",
      "args": ["-y", "@procedure-tech/mcp-google"]
    }
  }
}

Then use the google_add_account tool to connect your Google account.

Everything you need

Full access to Gmail, Drive, and Calendar with safety gates built in.

Gmail

Search, read, draft, send, and bulk-download attachments. Emails are always drafted first — nothing sends without your explicit confirmation.

📁

Google Drive

Search files by name or content, preview documents without context overload, download to disk, upload from disk, and manage sharing.

📅

Google Calendar

Check your schedule, find free slots, create events, and RSVP — across all your calendars and accounts.

👥

Multi-Account

Connect work, personal, and shared Google accounts. Name them with aliases like "work" or "personal" and add descriptions — no UUIDs to remember.

🔒

Local & Secure

Runs 100% on your machine. Tokens stored locally. Every API call goes directly from your computer to Google — no middleman, no analytics, no telemetry.

Tiered Scopes

Start with read-only access. Upgrade to compose or full permissions only when you need them. You control what the AI can do.

Three steps to get started

1

Install

One command. No Google Cloud project, no API keys, no config files. Just npx and go.

2

Connect

OAuth opens in your browser. Authorize your Google account. Tokens stay on your machine.

3

Use

Ask Claude to read emails, search Drive, check your calendar. It just works.

What's new

Latest updates and improvements.

v0.4.1 Latest May 2026
  • fix Non-ASCII subjects (em-dash, smart quotes, accents) now RFC 2047 encoded so recipients see them correctly instead of mojibake like â€"
  • fix Plain-text bodies no longer render with visible mid-sentence line breaks in Gmail — hard-wrapped paragraphs are unwrapped before send so clients reflow to the viewport
  • feat New bodyFormat: "text" | "html" parameter on gmail_create_draft, gmail_update_draft, gmail_create_draft_with_attachment, and gmail_reply_in_thread for HTML-formatted email
v0.4.0 April 2026
  • feat Smart file previews — drive_get_file_content now returns truncated content (default 10k chars) to protect AI context windows from overload
  • feat New drive_get_full_file_content tool for when you genuinely need the complete file
  • feat New drive_download_file tool — download files from Drive directly to local disk
  • feat Full-text search shorthand — use content:keyword in drive_search_files to search inside file contents
v0.3.3 April 2026
  • fix Attachment downloads now work reliably — fixed a bug where Gmail's ephemeral attachment IDs caused every download to fail
  • fix gmail_get_attachment now saves files directly to disk instead of returning binary data in the response
  • fix gmail_bulk_save_attachments no longer fails due to the same stale ID issue
v0.3.0 March 2026
  • feat File path support for attachments and uploads — the server reads large files directly from disk, bypassing AI context window limits
  • feat Gmail drafts with attachments now accept local file paths (PDFs, images, any file up to 25MB)
  • feat Drive file uploads accept local file paths (up to 50MB)
v0.2.4 March 2026
  • fix Made keytar optional to fix slow npx startup times
  • fix Configured OIDC trusted publishing for npm
v0.2.0 March 2026
  • feat GitHub Actions CI/CD pipeline for automated npm publishing
  • feat Account aliases — name accounts "work" or "personal" instead of UUIDs
  • feat Account descriptions for human-readable context
  • feat Bulk attachment download to local disk
  • feat Auto-open browser for OAuth flow
v0.1.3 March 2026
  • feat Google Calendar support — 10 tools for events, scheduling, RSVP
  • feat Google Drive support — 12 tools for files, folders, sharing
  • feat Shorthand query syntax for Drive search
  • fix Param coercion for MCP client compatibility
v0.1.1 February 2026
  • feat Zero-config OAuth — no Google Cloud project needed
  • feat Gmail read, draft, send with confirmation gates
  • feat Inbox management — labels, archive, trash
  • feat Tiered permission scopes (readonly, compose, full)
  • feat Static site with privacy policy and terms
🛠

Open source under MIT License. View the code, report issues, and contribute on GitHub. Built by Procedure.