Releases: leandro-santos-abreu/MultiGmailMCP
Release list
v1.1.0 — Google Calendar + update checker
Google Calendar support, plus a built-in update checker.
⚠️ Updating from v1.0.0? Reauthorize each account
v1.1.0 adds Calendar OAuth scopes, so existing accounts must be reauthorized
before the calendar tools work: run the app's setup wizard and click
Reauthorize next to each account (your mail tools keep working in the
meantime). New installs just go through setup normally.
New — Google Calendar
Ask Claude things like "what's on my calendar Friday?", "am I free Thursday
afternoon?", "schedule a 30-min with sarah@example.com Tuesday 2pm", "move my
3pm to 4":
- List calendars and events (across all accounts at once), read event
details, and check free/busy. - Create (incl. natural-language quick-add), update, delete, and RSVP to
events. - Safety: emailing attendees (
send_updates="all") is treated like sending
mail — it defaults to off, and turning it on is gated by the confirmation
phrase. Deleting an event is marked destructive.
New — update checker
The app now tells you when a newer release is out: a banner in the setup UI, a
check_for_updates tool, and a one-time heads-up at the start of a Claude
conversation. It's notify-only — it never downloads or installs anything —
best-effort, and cached. Set GMAIL_MCP_NO_UPDATE_CHECK=1 to turn it off.
Download & run (Windows)
Download gmail-mcp.exe below (one file, ~22 MB, no install), double-click
it for the setup wizard, then restart Claude Desktop. First launch shows
SmartScreen ("unknown publisher") because the exe is unsigned →
More info → Run anyway. Windows-only build; unchanged from v1.0.0 otherwise.
See the README
for the full walkthrough.
v1.0.0 — Gmail Multi-Account MCP for Claude Desktop
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.