A lightweight Model Context Protocol (MCP) server that provides IMAP and SMTP email functionality for AI assistants like Claude in Cursor IDE. Built with TypeScript and optimized for easy deployment via npm/npx.
MCPpedia last refreshed this data
MCP Mail Server is an MCP server that a lightweight Model Context Protocol (MCP) server that provides IMAP and SMTP email functionality for AI assistants like Claude in Cursor IDE. Built with TypeScript and optimized for easy deployment via npm/npx. Its tool list has not been published yet over stdio and http, requires no API key, and scores 84/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"mcp-mail-server": {
"env": {
"IMAP_HOST": "your-imap-server.com",
"IMAP_PORT": "993",
"SMTP_HOST": "your-smtp-server.com",
"SMTP_PORT": "465",
"EMAIL_PASS": "your-password",
"EMAIL_USER": "your-email@domain.com",
"IMAP_SECURE": "true",
"SMTP_SECURE": "true"
},
"args": [
"-y",
"mcp-mail-server"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
A Model Context Protocol server for IMAP/SMTP email operations with Claude, Cursor, and other AI assistants.
Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.
npx -y 'mcp-mail-server' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
Checked mcp-mail-server against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in communication
Official TypeScript library for the Telnyx API
Open-source SMS gateway. Turn your Android phone into an SMS API: send and receive SMS from your apps over REST and webhooks. Self-hostable, with a free hosted plan.
Send email and newsletters with Mailtea over MCP, plus skills for email and website design.
CVSS scoring, IOC extraction, email header triage, hash/JWT/timestamp decoding, CISA KEV lookup.
MCP Security Weekly
Get CVE alerts and security updates for Mcp Mail Server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Give your AI assistant a local bridge to your email.
Search, read, organize, reply to, and send email through supported password- or app-password-based IMAP/SMTP accounts—from Claude, Cursor, Codex, and other MCP clients.
English · 简体中文
Why this server · Quick start · Client setup · Tools · Configuration · Optional security · Development
“Find the unread messages from Alice this week, summarize them, and move the finished thread to Archive.”
| 🔎 Find what matters Search across folders by sender, recipient, subject, body, date, read state, and reply state. | ✉️ Act without leaving the conversation Read, send, reply, move, and delete messages using natural language. |
| 📎 Work with attachments Inspect metadata, download files, and send local attachments through explicit filesystem allowlists. | 🔐 Keep control Run locally, connect directly to your mail provider, verify TLS certificates, and enforce payload limits. |
| Goal | Example prompt |
|---|---|
| Catch up | “Summarize my unread email from today.” |
| Find a message | “Find messages from finance@example.com about the Q3 budget.” |
| Organize the inbox | “Move the completed thread from INBOX to Archive.” |
| Reply with context | “Reply to the latest message from Alex and keep it in the same thread.” |
| Handle files | “Save the PDF attachment from that message to my Downloads folder.” |
| Send polished email | “Send the project update with my text and HTML signature.” |
[!IMPORTANT] Enable IMAP and SMTP for your account before starting. This server currently supports password or app-password authentication; OAuth2 is not yet supported.
Install Node.js 22.13.0 or newer before configuring your MCP client. All examples use npx -y mcp-mail-server, so there is no need to install the server globally.
Open Settings > Developer > Edit Config and add the server to claude_desktop_config.json:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"mcp-mail-server": {
"command": "npx",
"args": ["-y", "mcp-mail-server"],
"env": {
"IMAP_HOST": "your-imap-server.com",
"IMAP_PORT": "993",
"IMAP_SECURE": "true",
"SMTP_HOST": "your-smtp-server.com",
"SMTP_PORT": "465",
"SMTP_SECURE": "true",
"EMAIL_USER": "your-email@domain.com",
"EMAIL_ADDRESS": "your-email@domain.com",
"EMAIL_PASS"
... [View full README on GitHub](https://github.com/yunfeizhu/mcp-mail-server#readme)