# Gmail

This MCP server lets an agent search, read, send, and organize Gmail messages. Use it when email actions need to run from an IDE.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 57738 installs
- Author: gmail
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/gmail
- Updated: 2025-11-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/gmail-gmail

## What it does

Gmail gives the agent access to mailbox tasks such as message search, reading, sending, replies, and forwarding. It can create, edit, list, and remove drafts, work with conversation threads, and manage custom labels. Messages may be archived, moved to Trash, reported as spam, or handled through inbox triage.

The tool set includes separate actions for emails, threads, headers, drafts, labels, and attachment metadata. When sending or replying, a local attachment can be supplied with a URI such as `file:///absolute/path/to/file`. Reading an attachment returns its filename, MIME type, size, and Gmail attachment id when available, not its file contents.

Actions run through the connected Gmail account, so that account must be connected before mailbox operations can work. Bulk label changes and triage handle up to 50 messages per call. Repeating a query-based call can move to another result chunk, so blind retries can affect more messages.

## Requirements
- Remote server: `https://gmail.run.tools`
- Works with: Gmail

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http gmail https://gmail.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add gmail-gmail --url https://gmail.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gmail-gmail": {
            "url": "https://gmail.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gmail-gmail": {
            "type": "http",
            "url": "https://gmail.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http gmail-gmail https://gmail.run.tools
```

## When to use it
- search Gmail messages by query
- read a complete email thread
- draft and send a reply
- apply labels to selected messages
- forward an email with an attachment

## Example prompts
- Search Gmail for messages from `billing@example.com` received last month and list their subjects.
- Write a reply draft for the latest message in this thread.
- Find promotional emails and move them to Spam.

## Similar
- [google-gmail](https://affpapa.org/en/nevibecode/skills/google-gmail.md) — skill · 231 installs
- [gws-gmail-reply](https://affpapa.org/en/nevibecode/skills/gws-gmail-reply.md) — skill · 36700 installs
- [gws-gmail-send](https://affpapa.org/en/nevibecode/skills/gws-gmail-send.md) — skill · 76800 installs
- [gmail-to-crm-pipeline](https://affpapa.org/en/nevibecode/skills/gmail-to-crm-pipeline.md) — skill · 260 installs
- [gws-gmail-triage](https://affpapa.org/en/nevibecode/commands/gws-gmail-triage.md) — command · 78 installs
- [gmail-skill](https://affpapa.org/en/nevibecode/skills/gmail-skill.md) — skill · 3600 installs

## Other versions with the same name
- [gmail · pulsemcp](https://affpapa.org/en/nevibecode/mcp/gmail.md) — ★ 81 repo stars
- [Gmail · domdomegg](https://affpapa.org/en/nevibecode/mcp/domdomegg-gmail.md) — ★ 12 repo stars
- [Gmail · sallytion](https://affpapa.org/en/nevibecode/mcp/sallytion-gmail.md)

---
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
