v1.0.0 — Gmail Multi-Account MCP for Claude Desktop
·
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)
- Download
gmail-mcp.exebelow — one file (~22 MB) that bundles Python and
every dependency. No Python, no install. - Double-click it → the setup wizard opens in your browser.
- Follow the wizard: create a free Google Cloud OAuth client, connect your
account(s), and click Apply to config. - 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.jsonand account tokens live only on your machine
(%APPDATA%\GmailMCP) — they are never bundled into the exe.
See the README for the full walkthrough.