Skip to content

v1.0.0 — Gmail Multi-Account MCP for Claude Desktop

Choose a tag to compare

@leandro-santos-abreu leandro-santos-abreu released this 02 Aug 04:55
· 5 commits to main since this release

A local MCP server that lets Claude Desktop search, read, draft, send, and
organize email — and manage mailbox settings — across as many Gmail accounts as
you connect. Everything runs on your own machine; nothing is hosted.

Download & run (Windows)

  1. Download gmail-mcp.exe below — one file (~22 MB) that bundles Python and
    every dependency. No Python, no install.
  2. Double-click it → the setup wizard opens in your browser.
  3. Follow the wizard: create a free Google Cloud OAuth client, connect your
    account(s), and click Apply to config.
  4. Restart Claude Desktop. Done.

First launch shows Windows SmartScreen ("unknown publisher") because the exe is
unsigned → More info → Run anyway (it's your own app).

What Claude can do once connected

  • Read/search across all your accounts — including whole threads and attachments
  • Draft / reply / forward — sending is always a two-step confirm, never automatic
  • Organize: labels, archive, read/unread, star, trash (recoverable)
  • Settings: filters, vacation responder, IMAP/POP, forwarding, send-as, delegation
  • Connect a new Gmail on request (gmail_add_account)

Good to know

  • Windows build. macOS/Linux need a build made on that OS (same single-file result).
  • Unsigned → the SmartScreen prompt on first run.
  • ~7-day reauthorization is Google's policy for unverified apps — one click in the wizard when it happens.
  • No permanent delete — trash is recoverable; hard-delete is deliberately excluded, so nothing this does is irreversible.
  • Your OAuth credentials.json and account tokens live only on your machine
    (%APPDATA%\GmailMCP) — they are never bundled into the exe.

See the README for the full walkthrough.