MCP Mail
📧 MCP Mail Tool - AI-powered email management tool | 基于 MCP 的智能邮件管理工具
What is MCP Mail?
MCP Mail is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📧 mcp mail tool - ai-powered email management tool | 基于 mcp 的智能邮件管理工具
📧 MCP Mail Tool - AI-powered email management tool | 基于 MCP 的智能邮件管理工具
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- 📧 MCP Mail Tool - AI-powered email management tool | 基于 MCP
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-mailConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Mail
MCP Mail is an AI-powered email management server built on the Model Context Protocol that connects Claude and other AI assistants directly to any IMAP/SMTP-compatible email account. It enables sending rich text and HTML emails with attachments, browsing and searching inbox folders, managing message state, and accessing contacts — all through natural language requests. Users who want to handle their daily email workflow, automate triage, or draft and dispatch messages without switching apps will find MCP Mail an essential productivity tool.
Prerequisites
- Node.js 18+ and Python 3.8+ installed on the host machine
- An email account with IMAP and SMTP access enabled (Gmail, Outlook, QQ Mail, or any standard provider)
- App-specific password or account password with IMAP/SMTP permissions enabled at your email provider
- An MCP-compatible client such as Claude Desktop or Cursor
Clone the repository and install dependencies
Clone mcp-mail from GitHub, install Node.js dependencies, and compile the TypeScript source.
git clone https://github.com/shuakami/mcp-mail.git
cd mcp-mail
npm install
npm run buildEnable IMAP/SMTP at your email provider
Log in to your email provider's settings and enable IMAP access. For Gmail, go to Settings > See all settings > Forwarding and POP/IMAP and enable IMAP. Also generate an App Password under your Google Account security settings if you use 2FA.
Prepare your SMTP and IMAP credentials
Collect the exact server hostnames, ports, and credentials required. Gmail uses smtp.gmail.com:587 (STARTTLS) and imap.gmail.com:993 (TLS). QQ Mail uses smtp.qq.com:465 and imap.qq.com:993. Never use your primary password — use an app-specific password.
Configure your MCP client to launch the server
Edit your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) to add the mcp-mail server entry with all credentials in the env block.
{
"mcpServers": {
"mail-mcp": {
"command": "python3",
"args": ["/absolute/path/to/mcp-mail/bridging_mail_mcp.py"],
"env": {
"SMTP_HOST": "smtp.gmail.com",
"SMTP_PORT": "587",
"SMTP_SECURE": "false",
"SMTP_USER": "[email protected]",
"SMTP_PASS": "your-app-password",
"IMAP_HOST": "imap.gmail.com",
"IMAP_PORT": "993",
"IMAP_SECURE": "true",
"IMAP_USER": "[email protected]",
"IMAP_PASS": "your-app-password",
"DEFAULT_FROM_NAME": "Your Name",
"DEFAULT_FROM_EMAIL": "[email protected]"
}
}
}
}Restart Claude Desktop and test the connection
Restart your MCP client to load the new server. Ask the AI to list your mailbox folders — a successful list response confirms IMAP connectivity.
MCP Mail Examples
Client configuration
Complete Claude Desktop claude_desktop_config.json entry for MCP Mail with Gmail credentials.
{
"mcpServers": {
"mail-mcp": {
"command": "python3",
"args": ["/Users/yourname/mcp-mail/bridging_mail_mcp.py"],
"env": {
"SMTP_HOST": "smtp.gmail.com",
"SMTP_PORT": "587",
"SMTP_SECURE": "false",
"SMTP_USER": "[email protected]",
"SMTP_PASS": "your-app-password",
"IMAP_HOST": "imap.gmail.com",
"IMAP_PORT": "993",
"IMAP_SECURE": "true",
"IMAP_USER": "[email protected]",
"IMAP_PASS": "your-app-password",
"DEFAULT_FROM_NAME": "Your Name",
"DEFAULT_FROM_EMAIL": "[email protected]"
}
}
}
}Prompts to try
Example prompts that exercise MCP Mail's sending, reading, search, attachment, and folder management capabilities.
- "List all my mailbox folders"
- "Show me the 5 most recent emails in my inbox"
- "Send an email to [email protected] with subject 'Meeting Notes' and attach the file at /tmp/notes.pdf"
- "Search my inbox for emails from [email protected] mentioning 'contract'"
- "Mark all emails in the Promotions folder as read"
- "Download and summarise all attachments from email UID 2048"Troubleshooting MCP Mail
IMAP login failed or authentication error
Use an app-specific password rather than your account password. For Gmail, enable 2-Step Verification in your Google Account, then go to Security > App Passwords to generate one. Set IMAP_PASS and SMTP_PASS to this app password.
Server starts but AI cannot send emails
Confirm SMTP_HOST, SMTP_PORT, and SMTP_SECURE are correct for your provider. For port 587 set SMTP_SECURE=false (STARTTLS is negotiated automatically). For port 465 set SMTP_SECURE=true. Also confirm your provider allows SMTP access from third-party clients.
Python command not found when launching the bridge
The bridge script requires Python 3.8+. Run 'which python3' to find its path and use the full absolute path in the command field of your MCP config. On Windows use 'pythonw' to avoid a terminal window appearing.
Frequently Asked Questions about MCP Mail
What is MCP Mail?
MCP Mail is a Model Context Protocol (MCP) server that 📧 mcp mail tool - ai-powered email management tool | 基于 mcp 的智能邮件管理工具 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Mail?
Follow the installation instructions on the MCP Mail GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Mail?
MCP Mail works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Mail free to use?
Yes, MCP Mail is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Mail Alternatives — Similar Communication Servers
Looking for alternatives to MCP Mail? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Mail in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Mail?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.