English · עברית

multi-mail MCP

An MCP server for several Gmail accounts at once. It searches, reads, drafts and sends mail, and works with Claude Desktop, Claude Code and ChatGPT.

It has two transports:

• stdio (dist/server.js) runs locally, for Claude Desktop and Claude Code.
• Streamable HTTP (dist/http.js) is for ChatGPT, or any client that connects by URL. A token is required.

Each user brings their own Google OAuth client. Because of that, no Google app verification is needed and nothing passes through a third party. Mail goes only between your machine and Google.

The story behind it, with the comparison and examples: One MCP server for every Gmail account, in Claude and ChatGPT.

Tools

Choosing a mailbox:

• account accepts a full address, an alias (work), or the part before the @.
• With a single account connected, you can leave it out.
• MULTI_MAIL_DEFAULT sets a default account.

Replying:

• reply_to_message_id puts the reply in the right thread and fills in the recipient and subject.
• reply_all adds every original recipient.

Permissions: gmail.readonly and gmail.compose by default. The server cannot delete mail, move it to trash, or change settings.

• Calendar is opt-in per account (add --calendar), which adds calendar.readonly and calendar.events. The server reads events and free/busy, and creates events on your own calendar without inviting anyone. It has no tool to change or delete an event. The calendar tools appear only when at least one account has calendar enabled. Times are read in each calendar's own time zone. If a calendar is set wrong (a new Google account often defaults to UTC), set MULTI_MAIL_TZ=Asia/Jerusalem or pass time_zone to the tool.
• Labels are opt-in per account (add --labels), which adds gmail.modify. At Google's level that scope would also allow trashing mail, so the server has no trash tool and refuses the TRASH and SPAM labels.

Drafts-only mode

Start the server with --drafts-only

... View full README on GitHub