Skip to main content
Glama
Email MCP Server

Email MCP Server

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: Mailbridge MCP

Supported Providers (Auto-Detected)

Provider

IMAP

SMTP

Gmail / Google Workspace

imap.gmail.com:993

smtp.gmail.com:465

Outlook / Hotmail / Live

outlook.office365.com:993

smtp.office365.com:587

Yahoo Mail

imap.mail.yahoo.com:993

smtp.mail.yahoo.com:465

Zoho Mail (.com, .in, .eu, .com.au, .jp)

imap.zoho.com:993

smtp.zoho.com:465

iCloud / Me.com

imap.mail.me.com:993

smtp.mail.me.com:587

AOL Mail

imap.aol.com:993

smtp.aol.com:465

Any custom IMAP

Set IMAP_HOST env var

Set SMTP_HOST env var

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


18 Tools

Read (5)

Tool

Description

email_search

Search emails with query syntax

email_read

Read full email by ID

email_read_thread

Read entire conversation

email_inbox

Quick inbox view (unread filter)

email_profile

Account info

Send (5)

Tool

Description

email_send

Send email (HTML, CC, BCC, threading)

email_reply

Reply to email (auto-sets headers)

email_draft

Create draft

email_send_draft

Send existing draft

email_list_drafts

List all drafts

Manage (8)

Tool

Description

email_labels

List all folders/labels

email_create_label

Create new folder

email_archive

Archive messages

email_trash

Move to trash

email_delete

Permanent delete

email_mark_read / email_mark_unread

Toggle read status

email_star / email_unstar

Toggle star/flag

email_add_label / email_remove_label

Move between folders

Automation (7) — The Premium Features

Tool

Description

email_digest

Morning summary grouped by sender

email_suggest_reply

Prepare AI reply context

email_triage

Classify unread by priority

email_cleanup

Archive old/newsletter/social (dry-run)

email_cold_campaign

Personalized bulk emails with placeholders

email_follow_up

Find sent emails with no reply

email_contacts

Extract contacts from email history


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.

Available Tools

28 tools
email_add_labelB

Add label(s) to one or more messages.

Inputs: label_ids (required), message_ids (required).

email_archiveA

Archive one or more messages (removes from inbox, doesn't delete).

Inputs: message_ids (required).

email_cleanupB

Clean up inbox by archiving old emails, removing newsletters, and organizing. Returns actions taken for review before committing.

Inputs: dry_run, archive_social, older_than_days, archive_newsletters.

email_cold_campaignA

Send personalized cold emails from a template. Supports placeholders: {{name}}, {{company}}, {{custom}}. Creates drafts by default for review before sending.

Inputs: recipients (required), body_template (required), subject_template (required), cc, +3 more.

email_contactsA

Extract contacts from recent emails. Useful for building contact lists for campaigns.

Inputs: days, deduplicate, max_results.

email_create_labelA

Create a new Gmail label (folder/tag).

Inputs: name (required).

email_deleteA

Permanently delete one or more messages. WARNING: cannot be undone!

Inputs: confirm (required), message_ids (required).

email_digestA

Generate a digest of recent emails. Groups by sender, counts unread, highlights important messages. Perfect for morning email summaries.

Inputs: hours, label, max_results.

email_draftC

Create a draft email. Optionally create as a reply draft.

Inputs: to (required), body (required), subject (required), cc, +1 more.

email_follow_upA

Find emails that need follow-up: sent emails with no reply after N days.

Inputs: days_since, max_results.

email_inboxB

Get inbox messages. Shorthand for searching 'in:inbox'.

Inputs: max_results, unread_only.

email_labelsA

List all Gmail labels (folders/tags).

Inputs: no named parameters.

email_list_draftsB

List all draft emails.

Inputs: max_results.

email_mark_readB

Mark one or more messages as read.

Inputs: message_ids (required).

email_mark_unreadB

Mark one or more messages as unread.

Inputs: message_ids (required).

email_profileA

Get the authenticated Gmail account profile (email, total messages, threads).

Inputs: no named parameters.

email_readA

Read a full email by its ID. Returns headers, body, attachments info, and metadata.

Inputs: message_id (required), format.

email_read_threadA

Read an entire email thread (conversation). Returns all messages in the thread.

Inputs: thread_id (required).

email_remove_labelB

Remove label(s) from one or more messages.

Inputs: label_ids (required), message_ids (required).

email_replyA

Reply to an email. Automatically sets In-Reply-To header and threads the message. Use email_read first to get the message_id and original sender.

Inputs: body (required), message_id (required), reply_all.

email_sendC

Send an email. Supports HTML body, CC, BCC, and threading (reply to a message).

Inputs: to (required), body (required), subject (required), cc, +3 more.

email_send_draftA

Send an existing draft by its ID.

Inputs: draft_id (required).

email_starB

Star one or more messages.

Inputs: message_ids (required).

email_suggest_replyA

Read an email and generate context for an AI reply. Returns the email content formatted for an AI assistant to draft a reply. The AI agent should then use email_reply to send.

Inputs: message_id (required), context.

email_trashC

Move one or more messages to trash.

Inputs: message_ids (required).

email_triageB

Triage unread emails. Returns each email with priority classification and suggested actions (reply, archive, ignore, forward). Use with an AI agent to auto-process.

Inputs: max_emails, priority_senders.

email_unstarA

Remove star from one or more messages.

Inputs: message_ids (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 28 tools

    Disambiguation4/5

    Most tools target a distinct message, thread, label, or mailbox action, and descriptions clarify differences between send/reply, archive/trash/delete, and digest/triage/cleanup. A few adjacent automation helpers such as email_triage and email_cleanup could still be confused if descriptions are skimmed.

    Naming Consistency3/5

    The email_ prefix is consistent and all names use snake_case, but the verb+noun pattern is not followed consistently. Tools like email_inbox, email_profile, email_labels, email_digest, and email_contacts are noun-style, while email_list_drafts, email_mark_read, and email_create_label are verb-style, making the naming mixed but still readable.

    Tool Count2/5

    28 tools exceeds the 25+ threshold for too many, and several compound helpers such as email_digest, email_triage, email_cleanup, email_cold_campaign, and email_follow_up could be composed from the basic primitives. The set feels overpopulated even though each tool has a distinct role.

    Completeness4/5

    Core email workflows are well covered: search, read, send, reply, drafts, labels, flags, archive, trash, and delete all have dedicated tools. Minor gaps remain, such as no draft editing, no label deletion, and no attachment upload or forward, but agents can work around these.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to read, search, compose, and send emails by connecting to any IMAP/SMTP provider. It supports comprehensive mailbox management, including draft handling and message deletion, directly through natural language.
      10
      206 npm
      11
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to email accounts via IMAP/SMTP, enabling reading, searching, sending, and organizing emails with features like smart drafts, scheduling, and attachment handling.
      92 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to connect to any email provider via IMAP/SMTP, supporting account management and email operations like listing, sending, and marking emails.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to read, send, organize, and search emails across multiple IMAP/SMTP mailboxes.
      MIT