Email MCP Server
Allows interacting with AOL Mail accounts via IMAP/SMTP, providing tools for reading, sending, managing, and automating emails.
Allows interacting with Gmail or Google Workspace accounts via IMAP/SMTP, providing tools for reading, sending, managing, and automating emails.
Allows interacting with iCloud or Me.com email accounts via IMAP/SMTP, providing tools for reading, sending, managing, and automating emails.
Allows interacting with Zoho Mail accounts via IMAP/SMTP, providing tools for reading, sending, managing, and automating emails.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Email MCP Server check my inbox and summarize the important emails"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 | Set |
Just enter your email — the server auto-detects the provider.
18 Tools
Read (5)
Tool | Description |
| Search emails with query syntax |
| Read full email by ID |
| Read entire conversation |
| Quick inbox view (unread filter) |
| Account info |
Send (5)
Tool | Description |
| Send email (HTML, CC, BCC, threading) |
| Reply to email (auto-sets headers) |
| Create draft |
| Send existing draft |
| List all drafts |
Manage (8)
Tool | Description |
| List all folders/labels |
| Create new folder |
| Archive messages |
| Move to trash |
| Permanent delete |
| Toggle read status |
| Toggle star/flag |
| Move between folders |
Automation (7) — The Premium Features
Tool | Description |
| Morning summary grouped by sender |
| Prepare AI reply context |
| Classify unread by priority |
| Archive old/newsletter/social (dry-run) |
| Personalized bulk emails with placeholders |
| Find sent emails with no reply |
| Extract contacts from email history |
Quick Start
1. Generate an App Password
Gmail:
Select app → Generate → Copy the 16-char password
Outlook/Hotmail:
Create new app password → Copy
Yahoo:
Generate app password for "Mail"
Zoho:
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.js3. 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.jsUsage 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 toolsemail_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_searchA
Search Gmail messages using Gmail query syntax. Returns message IDs and snippets. Use email_read to get full content.
Inputs: query (required), page_token, max_results.
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
Scored across 28 tools
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.
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.
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.
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
Related MCP Connectors
Email for AI agents: read, search and send from your Gmail, Outlook, Yahoo, iCloud or IMAP inbox.
Gmail, Outlook, iCloud, Fastmail and any IMAP mailbox for your agent. Scoped OAuth, approved sends.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
AI email inbox and sending tools with attachments, search, live events, and webhooks.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables 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.10206 npm11MIT
- AlicenseNot gradedqualityDmaintenanceConnects 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 npm2MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to connect to any email provider via IMAP/SMTP, supporting account management and email operations like listing, sending, and marking emails.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to read, send, organize, and search emails across multiple IMAP/SMTP mailboxes.MIT