# gmail-mcp

Connects Gmail accounts to your AI assistant using a personal Cloudflare Worker. It reads, sends, and handles message threads across multiple mailboxes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 9
- Author: mkpoli
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mkpoli/gmail-mcp
- Updated: 2026-10-17
- HTML: https://affpapa.org/en/nevibecode/mcp/gmail-mcp

## What it does

The server deploys as a remote endpoint on your own Cloudflare Worker. It searches emails, sends new messages, forwards threads, and handles reply-all with quoted history. Attachments and inline images load directly. It also respects original character encodings without corrupting non-UTF-8 parts.

Each configured connection ties strictly to a single Google mailbox. Because of that design, an assistant cannot hit an unintended inbox through bad argument values. Refresh tokens remain inside your own `OAUTH_KV` namespace. Mailbox settings like filters or vacation notices remain untouched because the server omits the `gmail.settings` scope entirely.

## Requirements
- Works with: Gmail

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- send messages and reply-all with quoted history inside Claude Code
- manage several Google mailboxes without running a local background process
- read emails with non-UTF-8 charsets and extract attachments correctly
- access your email assistant securely from a laptop, browser, or mobile device

## Example prompts
- Find unread invoices from last week and summarize the total amounts.
- Reply to all recipients on the deployment thread and confirm the release time.
- Forward the latest message from Alice to the team and label it as `Reviewed`.

## Similar
- [gmail-skill](https://affpapa.org/en/nevibecode/skills/gmail-skill.md) — skill · 3600 installs
- [gmail](https://affpapa.org/en/nevibecode/skills/sanjay3290-gmail.md) — skill · 516 installs
- [Multi-Account Gmail](https://affpapa.org/en/nevibecode/mcp/multi-account-gmail.md) — MCP server · ★ 5
- [gws-gmail](https://affpapa.org/en/nevibecode/skills/gws-gmail.md) — skill · 82100 installs
- [gws-gmail-send](https://affpapa.org/en/nevibecode/skills/gws-gmail-send.md) — skill · 74800 installs
- [multi-gmail-mcp](https://affpapa.org/en/nevibecode/mcp/multi-gmail-mcp.md) — MCP server · ★ 19

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md