# email-mcp

Connects Gmail, Outlook, iCloud, and IMAP inboxes to AI agents. It handles message searching, drafting, replies, and bulk inbox cleanup via prompt.

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

## What it does

The server links the model to mail providers using native REST endpoints for Gmail and Microsoft Graph for Outlook. For iCloud and other providers, it falls back to standard IMAP and SMTP protocols. Credentials stay secured locally under AES-256-GCM encryption. Search calls return compact payloads by default, keeping prompt token consumption low.

Account configuration relies on an interactive CLI wizard. Running it requires the `-p` parameter explicitly; omitting this flag causes the process to freeze on stdin. Shared Gmail OAuth credentials are limited to pre-approved test accounts during Google verification. For regular Gmail usage, you must supply your own Google Cloud OAuth credentials via environment variables.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add email-mcp -- npx -y @marlinjai/email-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add marlinjai-email-mcp -- npx -y @marlinjai/email-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "marlinjai-email-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@marlinjai/email-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "marlinjai-email-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@marlinjai/email-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add marlinjai-email-mcp npx -y @marlinjai/email-mcp
```

## When to use it
- search inbox messages using sender and date filters
- clean up hundreds of old emails in one batch
- send email replies directly from the coding assistant
- manage multiple accounts across Gmail, Outlook, and IMAP simultaneously

## Example prompts
- Search my Gmail inbox for invoices received in the past seven days.
- Archive all newsletters older than one month from my Outlook account.
- Check connection status across all configured email accounts.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

## Other versions with the same name
- [email-mcp · codefuturist](https://affpapa.org/en/nevibecode/mcp/email-mcp.md) — ★ 136

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