Skip to content

Releases: leandro-santos-abreu/MultiGmailMCP

v1.1.0 — Google Calendar + update checker

Choose a tag to compare

@leandro-santos-abreu leandro-santos-abreu released this 02 Aug 15:26

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

Choose a tag to compare

@leandro-santos-abreu leandro-santos-abreu released this 02 Aug 04:55

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.