# Gmail

Connects your Gmail account via standard IMAP and SMTP without OAuth2 setup. Read inbox items, run searches, and send emails directly through your agent.

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

## What it does

The server exposes three tools to your coding assistant: `listMessages` to inspect recent inbox messages, `findMessage` to locate specific emails using standard Gmail query syntax, and `sendMessage` to compose and deliver emails with optional `cc` and `bcc` headers.

Instead of registering apps in Google Cloud Console, this implementation relies on direct socket connections to IMAP on port 993 and SMTP on port 587. You can run it via Node.js after running `npm run build` or inside a container using Docker. Updating the host values in `.env` also allows redirecting the server to Outlook or third-party providers.

Direct login using your primary Google account password fails immediately: you must activate two-factor authentication and generate a dedicated 16-character app password under account security settings.

## Requirements
- Needs: Docker
- 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
- inspect recent inbox messages without leaving the terminal or editor
- locate conversations using query syntax like `has:attachment` or `is:unread`
- dispatch outgoing emails with subject lines and recipients via SMTP

## Example prompts
- List the last 15 emails from my inbox
- Find unread messages with subject invoice
- Send an email to team@example.com with subject Deployment update and body Build succeeded

## Similar
- [Fluxmail](https://affpapa.org/en/nevibecode/mcp/fluxmail.md) — MCP server · ★ 9 repo stars
- [gws-gmail-send](https://affpapa.org/en/nevibecode/skills/gws-gmail-send.md) — skill · 76800 installs
- [recipe-create-gmail-filter](https://affpapa.org/en/nevibecode/skills/recipe-create-gmail-filter.md) — skill · 32400 installs
- [gws-gmail-triage](https://affpapa.org/en/nevibecode/commands/gws-gmail-triage.md) — command · 78 installs
- [email-mcp](https://affpapa.org/en/nevibecode/mcp/marlinjai-email-mcp.md) — MCP server · ★ 26 repo stars
- [c-email](https://affpapa.org/en/nevibecode/skills/c-email.md) — skill · ★ 179 repo stars

## Other versions with the same name
- [Gmail · ](https://affpapa.org/en/nevibecode/mcp/gmail-gmail.md) — 57738 installs
- [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

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