Skip to content
MCP server

Gmail MCP

Self-hosted Gmail MCP server on your own Cloudflare Worker, for multiple Google accounts

Pricing
Open source
Platforms
API, self-hosted, Web
Version
0.3.0
Listing updated
today

Similar MCP servers

About Gmail MCP

Gmail MCP is an open-source MCP server for communication. It is available on API, self-hosted, Web, iOS and Android.

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.

Tools this server provides (24)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Open source under MIT; self-hosted on the user's own Cloudflare Worker.

More servers for the same service

Gmail MCP 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.

How AIPoweredBot checks servers