Email MCP Server

Universal email integration for AI assistants. Works with Gmail, Outlook, Yahoo, Zoho, iCloud, AOL, and any IMAP email provider.

Read, send, reply, draft, manage, clean up, run cold email campaigns, auto-triage, and track follow-ups — all through the Model Context Protocol.

Compatible with Claude Desktop, Cursor, Hermes Agent, Windsurf, and any MCP client.

Why This Exists

Every email MCP out there only works with Gmail via Google Cloud OAuth. This one:

• Works with ANY email provider — Gmail, Outlook, Yahoo, Zoho, iCloud, AOL, custom domains

• No Google Cloud project needed — uses IMAP + App Passwords (free, 30 seconds)

• 18 tools — full email management + AI-powered automation

• Zero data leaves your machine — everything runs locally

Related MCP server: IMAP Email MCP Server

Supported Providers (Auto-Detected)

Just enter your email — the server auto-detects the provider.

18 Tools

Read (5)

Send (5)

Manage (8)

Automation (7) — The Premium Features

Quick Start

1. Generate an App Password

Gmail:

1. Go to https://myaccount.google.com/apppasswords

2. Select app → Generate → Copy the 16-char password

Outlook/Hotmail:

1. Go to https://account.live.com/proofs/AppPassword

2. Create new app password → Copy

Yahoo:

1. Go to https://login.yahoo.com/account/security

2. Generate app password for "Mail"

Zoho:

1. Go to https://accounts.zoho.com/home#security/app-passwords

2. Generate new app password → Copy

2. Install & Run

cd email-mcp-server
npm install
npm run build

# Set credentials
export EMAIL_ADDRESS="you@example.com"
export EMAIL_PASSWORD="your-app-password"

# Run
node build/index.js

3. Connect to Your AI

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "email": {
      "command": "node",
      "args": ["C:/path/to/email-mcp-server/build/index.js"],
      "env": {
        "EMAIL_ADDRESS": "you@example.com",
        "EMAIL_PASSWORD": "your-app-password"
      }
    }
  }
}

Cursor (.cursor/mcp.json): Same structure as above.

Hermes Agent:

hermes mcp add email --command node --args C:/path/to/email-mcp-server/build/index.js

Usage Examples

"Check my inbox and summarize the important emails" "Read the email from john@company.com and draft a reply" "Clean up my inbox — archive all newsletters older than 7 days" "Send cold emails to these 5 prospects about web development" "Show me emails I sent that haven't gotten a reply" "Triage my unread emails by priority"

Cold Email Campaign

{
  "recipients": [
    { "email": "john@acme.com", "name": "John", "company": "Acme Corp" },
    { "email": "sarah@startup.io", "name": "Sarah", "company": "StartupIO" }
  ],
  "subject_template": "Quick question about {{company}}'s tech stack",
  "body_template": "<p>Hi {{name}},</p><p>I noticed {{company}} is growing fast...</p>",
  "create_drafts": true
}

Always use create_drafts: true first to review before sending.

Custom IMAP/SMTP

For providers not in the auto-detect list:

export IMAP_HOST="mail.yourprovider.com"
export IMAP_PORT="993"
export SMTP_HOST="smtp.yourprovider.com"
export SMTP_PORT="465"

Security

• Credentials in environment variables only (never written to disk)

• All processing local — no external API calls

• App Passwords revocable anytime from provider settings

License

MIT — Use freely, modify, sell as part of your services.