← 返回目录

email-mcp

社区

功能完备的 IMAP/SMTP 邮箱 MCP 服务器，支持多账户、实时监控与 AI 分类。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 127 热门
传输方式: stdio（本地进程）
运行环境: Node.js 22+ · Docker
凭据: 需要 API Key / 凭据
许可证: LGPL-3.0
最近提交: 4 个月前
工具数: 47

49FMRS · D

一个功能丰富的邮件 MCP 服务器，提供全面的 IMAP/SMTP 支持，包括多账户、实时监视、AI 分类、调度和日历集成。安装简单，支持多种客户端。需要注意安全性和权限，确保正确配置。

最强项 · 文档质量 15/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

7/20

维护活跃度

8/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 6/20: 仅审阅 README 与 manifest，未提供 CI 工作流、测试或可执行源码，无法验证启动、MCP 初始化握手和工具实际行为。README 内部存在矛盾：架构小节称 42 个工具，API 表与 manifest 称 47 个；且无错误处理/边缘用例证据，按静态校准扣分。
安全与权限 7/20: README 声称 TLS、速率限制、不记录密码、附件上限 5MB 和 OAuth2 实验支持，但无源码佐证。配置示例在 TOML 中明文保存密码和 refresh_token，未说明文件权限；永久删除等危险操作未见明确二次确认。未发现恶意或真实令牌示例，不触发红线。
维护活跃度 8/20: 仓库未归档，存在 LGPL-3.0 许可证，npm 版本 0.2.3 可见；但未提供提交历史、发布日期或安全响应渠道，30 个未关闭 issue 无处理证据，难以确认持续维护活跃度。
文档质量 15/20: README 覆盖面广：安装、多种客户端配置、CLI、配置、调度、watcher、工具/提示/资源表格、架构图均有。扣分原因是内部矛盾（42 vs 47 工具）、缺少故障排查指南，以及未披露 AI triage 的成本/限制（仅有速率限制）。
安装易用性 13/20: 提供 npx/pnpm/Docker 安装、Claude/VS Code/Cursor/Windsurf/Zed/Mistral Vibe 配置示例、环境变量单账户方案和引导向导。但要求 Node ≥22，仍依赖配置文件创建；无 CI/测试可验证命令可用，静态校准上限为 15，故给 13。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络修改第三方账户数据

适合谁

需要多账户邮箱管理的用户
需要实时邮件监控和 AI 分类的用户
需要邮件调度和日历功能的用户
希望与多个 MCP 客户端（Claude、Cursor 等）集成的用户

不适合谁

仅需要基础读/发邮件的用户（可能过大）
不使用 IMAP/SMTP 的邮箱服务
需要生产级稳定性且对实验性 OAuth2 有顾虑的用户

所需权限

读取邮件和邮箱信息
发送邮件
管理邮件（移动、删除、标记）
管理标签
访问本地日历（macOS/Linux）
创建操作系统级调度任务（scheduler install）
发送桌面通知和 Webhook 请求

风险与副作用

需要存储邮件凭据（应用密码或 OAuth2 令牌）
访问权限广泛：可能读取、发送、删除所有邮件
实验性 OAuth2 可能不稳定
调度邮件依赖机器在线，否则可能错过时间
桌面通知可能需要额外权限

安装接入

准备工作

运行环境：Node.js 22+ · Docker

MCP_EMAIL_PASSWORD 可选密钥邮箱密码或应用专用密码（如 Gmail 应用密码），在邮箱服务商的安全设置中生成，属敏感凭据。

EMAIL_ACCOUNTS 可选密钥 Mistral Vibe 等客户端中直接传入账户 JSON（含密码）以替代配置文件，属敏感凭据。

其他可选配置项（16 个）

MCP_EMAIL_ADDRESS 可选单账户模式下（无配置文件）的邮箱地址，即你自己的邮箱。

MCP_EMAIL_IMAP_HOST 可选 IMAP 服务器主机名，如 imap.gmail.com，由邮箱服务商提供。

MCP_EMAIL_SMTP_HOST 可选 SMTP 服务器主机名，如 smtp.gmail.com，由邮箱服务商提供。

MCP_EMAIL_ACCOUNT_NAME 可选账户显示名称，默认 default，可选。

MCP_EMAIL_FULL_NAME 可选发件时显示的姓名，可选。

MCP_EMAIL_USERNAME 可选登录用户名，默认使用邮箱地址，可选。

MCP_EMAIL_IMAP_PORT 可选 IMAP 端口，默认 993。

MCP_EMAIL_IMAP_TLS 可选是否启用 IMAP TLS，默认 true。

MCP_EMAIL_SMTP_PORT 可选 SMTP 端口，默认 465。

MCP_EMAIL_SMTP_TLS 可选是否启用 SMTP TLS，默认 true。

MCP_EMAIL_SMTP_STARTTLS 可选是否使用 STARTTLS，默认 false。

MCP_EMAIL_SMTP_VERIFY_SSL 可选是否校验 SSL 证书，默认 true。

MCP_EMAIL_SMTP_POOL_ENABLED 可选是否启用 SMTP 连接池，默认 true。

MCP_EMAIL_SMTP_POOL_MAX_CONNECTIONS 可选连接池最大连接数，默认 1。

MCP_EMAIL_SMTP_POOL_MAX_MESSAGES 可选每条池化连接最大消息数，默认 100。

MCP_EMAIL_RATE_LIMIT 可选每分钟最大发送数，默认 10。

确保 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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@codefuturist/email-mcp",
        "stdio"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add email -- npx -y @codefuturist/email-mcp stdio

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

运行 `npx @codefuturist/email-mcp setup` 添加账户后重启客户端，工具列表中应出现 47 个工具（如 list_emails、search_emails、send_email），调用 check_health 返回连接状态和 IMAP 能力即证明配置成功。

常见排障

确保 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 助手这样说：

搜索我最近一周内来自 github.com 的所有邮件，并列出发件人和主题。
帮我给 personal 账户里来自 [email protected] 的最新邮件写一封回复并发送。
把我的收件箱前 20 封未读邮件做一次分类整理，给订阅邮件打上 Newsletter 标签。
查看这封邮件里有没有日历邀请，如果有就添加到我的本地日历。

工具能力 47

list_accounts 只读

列出所有已配置的电子邮件账户。

list_mailboxes 只读

列出文件夹及其未读计数和特殊用途标志。

list_emails 只读

分页列出电子邮件，支持日期、发件人、主题和标志筛选。

get_email 只读

读取完整邮件内容，包含附件元数据。

get_emails 只读

一次调用获取多封邮件的完整内容（最多 20 封）。

get_email_status 只读

获取邮件的已读/已标记/标签状态，不获取正文。

search_emails 只读

在主题、发件人和正文中按关键词搜索邮件。

download_attachment 只读

按文件名下载邮件附件。

展开其余 39 个工具

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 只读

检查本地日历是否可访问。

使用场景

让 AI 助手读取、搜索和发送邮件

自动对收件箱进行 AI 分类和优先级划分

安排未来邮件发送

提取日历事件和创建提醒

通过静态规则和 IMAP IDLE 监视器实现实时通知

支持客户端

Claude Desktop

VS Code

Cursor

Windsurf

Zed

Mistral Vibe

依据项目文档列出，未经本站实测。

详细介绍

email-mcp 是一个基于 Model Context Protocol 的电子邮件 MCP 服务器，通过 IMAP 和 SMTP 提供全面的电子邮件能力。它允许 AI 助手跨多个账户读取、搜索、发送、管理、安排和分析电子邮件，提供 47 个工具、7 个提示和 6 个资源，并包含 OAuth2 支持（实验性）、邮件调度、日历提取、分析、提供商感知的标签管理、实时 IMAP IDLE 监视器（带 AI 分类）、可自定义预设和静态规则，以及引导式设置向导。