适合谁
- 需要多账户邮箱管理的用户
- 需要实时邮件监控和 AI 分类的用户
- 需要邮件调度和日历功能的用户
- 希望与多个 MCP 客户端（Claude、Cursor 等）集成的用户
E
49FMRS · D
一个功能丰富的邮件 MCP 服务器，提供全面的 IMAP/SMTP 支持，包括多账户、实时监视、AI 分类、调度和日历集成。安装简单，支持多种客户端。需要注意安全性和权限，确保正确配置。
email-mcp 是一个基于 Model Context Protocol 的电子邮件 MCP 服务器，通过 IMAP 和 SMTP 提供全面的电子邮件能力。它允许 AI 助手跨多个账户读取、搜索、发送、管理、安排和分析电子邮件，提供 47 个工具、7 个提示和 6 个资源，并包含 OAuth2 支持（实验性）、邮件调度、日历提取、分析、提供商感知的标签管理、实时 IMAP IDLE 监视器（带 AI 分类）、可自定义预设和静态规则，以及引导式设置向导。
工具能力
list_accounts
列出所有已配置的电子邮件账户。
list_mailboxes
列出文件夹及其未读计数和特殊用途标志。
list_emails
分页列出电子邮件，支持日期、发件人、主题和标志筛选。
get_email
读取完整邮件内容，包含附件元数据。
get_emails
一次调用获取多封邮件的完整内容（最多 20 封）。
get_email_status
获取邮件的已读/已标记/标签状态，不获取正文。
search_emails
在主题、发件人和正文中按关键词搜索邮件。
download_attachment
按文件名下载邮件附件。
find_email_folder
定位邮件所在的真实文件夹（解析虚拟文件夹）。
extract_contacts
从近期邮件头中提取唯一联系人。
get_thread
通过 References/In-Reply-To 重建会话线程。
list_templates
列出可用的邮件模板。
get_email_stats
邮件数据分析——规模、热门发件人、每日趋势。
check_health
检查连接健康、延迟、配额和 IMAP 能力。
send_email
发送新邮件（纯文本或 HTML，支持抄送/密送）。
reply_email
回复邮件，正确设置线程头（In-Reply-To、References）。
forward_email
转发邮件，引用原始内容。
save_draft
将邮件草稿保存到草稿文件夹。
send_draft
发送现有草稿并移出草稿文件夹。
apply_template
应用模板并进行变量替换。
schedule_email
安排邮件在未来发送。
list_scheduled
按状态列出已安排的邮件。
cancel_scheduled
取消待发送的已安排邮件。
move_email
在文件夹之间移动邮件。
delete_email
将邮件移动到废纸篓或永久删除。
mark_email
标记为已读/未读、加星/去星。
bulk_action
对最多 100 封邮件执行批量操作。
create_mailbox
创建新的邮箱文件夹。
rename_mailbox
重命名现有邮箱文件夹。
delete_mailbox
永久删除邮箱及其内容。
list_labels
发现可用标签（自动检测提供商策略）。
add_label
为邮件添加标签（ProtonMail 文件夹、Gmail X-GM-LABELS 或 IMAP 关键字）。
remove_label
从邮件移除标签。
create_label
创建新标签。
delete_label
删除标签。
get_watcher_status
显示 IMAP IDLE 连接、监控的文件夹和最后见到的 UID。
list_presets
列出可用的 AI 分类预设及其描述和建议标签。
get_hooks_config
显示当前 hooks 配置——预设、规则和自定义说明。
configure_alerts
在运行时更新警报/通知设置。
check_notification_setup
诊断桌面通知支持并提供设置说明。
test_notification
发送测试通知以验证操作系统权限。
extract_calendar
从邮件中提取 ICS/iCalendar 事件。
analyze_email_for_scheduling
分析邮件以检测事件和值得提醒的内容。
add_to_calendar
将邮件事件添加到本地日历（macOS/Linux）。
create_reminder
从邮件在 macOS Reminders.app 中创建提醒。
list_calendars
列出所有可用的本地日历。
check_calendar_permissions
检查本地日历是否可访问。
安装接入
- 确保 Node.js ≥ 22。\n2. 运行
npx @codefuturist/email-mcp setup或使用email-mcp account add交互式添加账户。\n3. 使用email-mcp install自动注册到支持的 MCP 客户端（Claude Desktop、VS Code、Cursor、Windsurf、Zed）。\n4. 或者手动添加配置片段（见 README）。
claude_desktop_config.json
{
"mcpServers": {
"email": {
"command": "npx",
"args": [
"-y",
"@codefuturist/email-mcp",
"stdio"
]
}
}
}
选型与风险
不适合谁
- 仅需要基础读/发邮件的用户（可能过大）
- 不使用 IMAP/SMTP 的邮箱服务
- 需要生产级稳定性且对实验性 OAuth2 有顾虑的用户
所需权限
- 读取邮件和邮箱信息
- 发送邮件
- 管理邮件（移动、删除、标记）
- 管理标签
- 访问本地日历（macOS/Linux）
- 创建操作系统级调度任务（scheduler install）
- 发送桌面通知和 Webhook 请求
风险与副作用
- 需要存储邮件凭据（应用密码或 OAuth2 令牌）
- 访问权限广泛：可能读取、发送、删除所有邮件
- 实验性 OAuth2 可能不稳定
- 调度邮件依赖机器在线，否则可能错过时间
- 桌面通知可能需要额外权限
常见排障
- 确保 Node.js ≥ 22
- 检查 `email-mcp test` 验证连接
- 检查配置文件路径 `email-mcp config path`
- 检查 IMAP/SMTP 主机和端口是否正确（例如 Gmail 的 imap.gmail.com:993, smtp.gmail.com:465）
- 对于 Gmail 等需要应用密码，而非普通密码
- 确保调度守护进程已安装（`email-mcp scheduler install`）
- 查看日志或运行 `email-mcp config show` 确认配置
使用场景
让 AI 助手读取、搜索和发送邮件
自动对收件箱进行 AI 分类和优先级划分
安排未来邮件发送
提取日历事件和创建提醒
通过静态规则和 IMAP IDLE 监视器实现实时通知
支持客户端
Claude Desktop完整支持
VS Code完整支持
Cursor完整支持
Windsurf完整支持
Zed完整支持
Mistral Vibe完整支持