A
licenseA
qualityA
maintenanceProvides IMAP and SMTP capabilities, enabling developers to manage email services with seamless integration and automated workflows.
21
3,732 PyPI
390
BSD 3-Clause
@fuyouai/email-mcp
Officialby fuyouai
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., "@@fuyouai/email-mcp list my recent emails in the inbox"
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.
@fuyouai/email-mcp
通过 MCP 读写邮箱：收信用 IMAP，发信用 SMTP。默认参数适配腾讯企业邮箱（exmail.qq.com）。
工具
Tool | 说明 |
| 列出文件夹 |
| 列出邮件摘要 |
| 按条件搜索 |
| 读取单封正文与附件信息 |
| 发送邮件（环境变量 |
Related MCP server: cpanel-mail-mcp
要求
Node.js 18+
邮箱已开启 IMAP；发信需开启 SMTP
腾讯企业邮开启安全登录时，使用客户端专用密码（IMAP 说明）
在 Cursor 中使用
npx -y @fuyouai/email-mcpmcp.json 示例（把账号与密码换成你自己的；密码不要提交到仓库）：
{
"mcpServers": {
"email": {
"command": "npx",
"args": ["-y", "@fuyouai/email-mcp"],
"env": {
"IMAP": "imap.exmail.qq.com:993",
"MAIL_USER": "you@yourcompany.com",
"MAIL_PASSWORD": "客户端专用密码",
"IMAP_SECURE": "true",
"SMTP": "smtp.exmail.qq.com:465",
"SMTP_SECURE": "true",
"SMTP_ENABLED": "true"
}
}
}
}安装到全局后，可执行 CLI：email-mcp。
环境变量
变量 | 说明 | 默认 |
| 收信 |
|
| 登录邮箱（收/发共用） | 必填 |
| 密码或客户端专用密码 | 必填 |
| IMAP 使用 TLS |
|
| 读信正文最大长度 |
|
| 发信 |
|
| SMTP 使用 TLS |
|
| 是否注册发信工具 |
|
| 发信账号与收信不同时填写 | 默认同 |
| 发件人显示地址 | 默认同发信登录账号 |
海外机房可将 IMAP / SMTP 改为 hwimap.exmail.qq.com:993、hwsmtp.exmail.qq.com:465。
send_message 参数示例
{
"to": "colleague@company.com",
"subject": "会议提醒",
"text": "明天下午 3 点开会。"
}多个收件人："to": "a@x.com, b@x.com" 或 "to": ["a@x.com", "b@x.com"]。text 与 html 至少填一项。
Available Tools
5 toolsget_messageA
获取单封邮件的完整内容（主题、正文、附件元数据）
Inputs: uid (required), folder.
list_foldersA
列出邮箱中的所有文件夹（IMAP LIST）
Inputs: no named parameters.
list_messagesA
列出指定文件夹中的邮件（默认 INBOX，按 UID 倒序）
Inputs: limit, folder, unseen_only.
search_messagesB
按条件搜索邮件（IMAP SEARCH）
Inputs: from, limit, since, folder, +2 more.
send_messageA
通过 SMTP 发送邮件（环境变量 SMTP，如 smtp.exmail.qq.com:465）。text 与 html 至少填一项。
Inputs: to (required), subject (required), cc, bcc, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
A3.8/5.0
Scored across 5 tools
Disambiguation5/5
Each tool has a distinct purpose: listing folders, listing messages, searching messages, fetching a single message, and sending. Even though list_messages and search_messages both return messages, their usage is clearly differentiated by the description (folder browsing vs. condition-based search).
Naming Consistency5/5
All tool names follow the consistent verb_noun pattern: list_folders, list_messages, search_messages, get_message, send_message. There are no mixed conventions or vague verbs, making the API predictable.
Tool Count5/5
With exactly 5 tools, the server is well-scoped for basic email operations. It covers the core actions (list, search, read, send) without unnecessary bloat or an overly thin surface.
Completeness3/5
The toolset covers reading and sending email, but lacks common email management operations such as deleting, moving, or marking messages as read/unread. This is a notable gap for a full email workflow, though an agent can still accomplish basic tasks.
Maintenance
ActivityInactive
ResponsivenessNo recent community issues
Related MCP Connectors
Email for AI agents: read, search and send from your Gmail, Outlook, Yahoo, iCloud or IMAP inbox.
Gmail, Outlook, Hotmail, Microsoft 365, Yahoo, iCloud and other IMAP mailboxes: search, read, send.
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
Hosted email MCP for your own Gmail, Outlook.com, Microsoft 365, iCloud or IMAP inbox: read, search, draft, reply in thread, forward and file mail. It moves or flags up to 500 messages in one call, and a send leaves exactly one copy in Sent. A calendar is a separate connection, and connecting one adds diary and scheduling tools.
Related MCP Servers
- AlicenseAqualityBmaintenanceManages email accounts via IMAP/SMTP, enabling reading, searching, sending, replying, forwarding, and folder management with multi-user and OAuth support.2239 PyPI1MIT
- AlicenseBqualityCmaintenanceEnables sending, listing, and reading email messages via IMAP/POP3 with support for multiple providers, including NetEase, QQ, Gmail, and Outlook.72,126 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables receiving and sending email via IMAP and SMTP across multiple accounts, with tools for listing, searching, reading, replying, and managing messages.MIT