# Gmail MCP

> Gmail MCP is an open-source MCP server for communication. Self-hosted Gmail MCP server on your own Cloudflare Worker, for multiple Google accounts. It is available on API, self-hosted, Web, iOS and Android.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted, Web, iOS, Android
- **Repository:** https://github.com/mkpoli/gmail-mcp
- **MCP Registry name:** io.github.mkpoli/gmail-mcp
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

The README says this server lets an AI assistant search, read, send, reply-all, forward and draft Gmail across several Google accounts at once. Each MCP connection is bound to a single Google account, so a wrong argument cannot reach another mailbox.

It runs as a remote server on the user's own Cloudflare Worker rather than a local process, so the same connection can be used from Claude Code, claude.ai in a browser, or a phone. The Google refresh token is stored in the user's own Cloudflare KV namespace, and mail is passed through rather than stored.

Setup requires a Google Cloud OAuth client, a Cloudflare account and bun, and the README walks through publishing the OAuth app to avoid seven-day token expiry. It is aimed at people who want Gmail access from an assistant without handing a vendor their refresh token.

## Features

- **Multi-account connections:** Each MCP connection signs in to one Google account, and several accounts can be connected to one deployment.
- **Reply-all and forwarding:** Replies carry the original thread, References chain and quoted history, and forwards reproduce the forwarded envelope.
- **Attachments and inline images:** Files and cid: inline images can be sent, and large attachments are staged or returned as time-limited download links.
- **Drafts, labels and trash:** Drafts can be created, updated and sent, labels managed in batches, and threads or messages trashed and restored.
- **Self-hosted OAuth gate:** An allowlist of verified Google emails controls who may sign in, and rate limits cap Gmail calls per account.

## Good for

- Letting an AI assistant triage and reply to a work inbox from a phone
- Drafting replies in Gmail for review before sending
- Searching and reading a long mailing-list thread without filling the assistant's context
- Managing labels and bulk-trashing messages across a personal and work account

## Tools

- `whoami`: Returns the signed-in account.
- `search_messages`: Searches messages in the mailbox.
- `get_message`: Reads a single message.
- `get_thread`: Reads a thread.
- `get_attachment`: Fetches an attachment.
- `send_message`: Sends an email.
- `reply_all`: Replies to all recipients of a message with quoted history.
- `forward_message`: Forwards a message.
- `create_draft`: Creates a draft, optionally as a reply.
- `update_draft`: Updates fields of an existing draft.
- `send_draft`: Sends a draft.
- `delete_draft`: Deletes a draft.
- `list_drafts`: Lists drafts.
- `list_labels`: Lists labels.
- `create_label`: Creates a label.
- `update_label`: Updates a label.
- `delete_label`: Deletes a label.
- `modify_labels`: Adds or removes labels on a message.
- `modify_thread_labels`: Adds or removes labels on a thread.
- `batch_modify_messages`: Changes labels on many messages at once.
- `trash_message`: Moves a message to trash.
- `untrash_message`: Restores a message from trash.
- `trash_thread`: Moves a thread to trash.
- `untrash_thread`: Restores a thread from trash.

## FAQ

### Where does the Google refresh token live?

The README says refresh tokens are encrypted inside their OAuth grant in the user's own Cloudflare KV namespace, and the session's Durable Object holds the hour-lived access token.

### Can it run without a custom domain?

Yes. The README says that without a domain the Worker answers on workers.dev.

### Does it store my email?

The README states that mail is never stored and passes through the Worker.

### What does it cost to run?

The README mentions Cloudflare's Workers Free plan limits and the paid plan's higher subrequest allowance, but does not state a price for the project itself.

### Is Gmail MCP free?

Yes. Gmail MCP is open source, so you can use and self-host it for free.

### What are the best alternatives to Gmail MCP?

The closest alternatives to Gmail MCP are Gmail, Gws Connector, Google Gmail, mcp4mail and mailmcp.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.

## Alternatives

- [Gmail](https://ai-powered.com/mcp/gmail-5): Gmail is a freemium MCP server for communication.
- [Gws Connector](https://ai-powered.com/mcp/gws-connector): Gws Connector is an open-source MCP server for productivity.
- [Google Gmail](https://ai-powered.com/mcp/google-gmail-2): Google Gmail is an open-source MCP server for communication.
- [mcp4mail](https://ai-powered.com/mcp/mcp4mail): mcp4mail is an open-source MCP server for communication.
- [mailmcp](https://ai-powered.com/mcp/mailmcp): mailmcp is a freemium MCP server for communication.
- [mcp-mail](https://ai-powered.com/mcp/mcp-mail): mcp-mail is an open-source MCP server for communication.
- [Lettio MCP](https://ai-powered.com/mcp/lettio-mcp): Lettio MCP is an open-source MCP server for communication.
- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp): Google Workspace MCP is an open-source MCP server for productivity.

---
Source: https://ai-powered.com/mcp/gmail-mcp-3
