Mcp Email

mcp-email

用于 IMAP 和 SMTP 的可自托管 MCP 服务。在一个配置中管理多个账户。专为 Claude Code 和任何兼容 MCP 的客户端打造。

在 Gumroad 购买 — $49 · 产品介绍页 · 提供商配置文档

---

这个仓库是什么

这是付费产品 mcp-email 的公开页面，该产品由 OneShotForge 提供。**源代码包含在 Gumroad 上出售的付费套件中。**此仓库包含：

• 你正在阅读的 README（功能、范围、常见问题）
• 完整的各提供商配置文档（docs/CONFIG.md）
• 公开更新日志（CHANGELOG.md）
• 许可条款（LICENSE）

如果你正在考虑购买：这些信息足以帮你判断 mcp-email 是否适合你的配置。购买链接在页面顶部。

如果你已经购买：完整的 TypeScript 源代码、Docker 配置、构建配置和完整安装指南都在结账后收到的 zip 文件中。

---

为什么要做这个

Anthropic 的 MCP 规范让 Agent 能够使用你的工具。电子邮件是大家最常需要的工具。但我试过的现有“MCP 邮件”服务，要么把你限制在 Gmail 上，要么要求耗时一下午的 OAuth 配置，要么一连接第二个账户就会出问题。

在逐一排查这些问题后，我为自己开发了 mcp-email。我现在出售它，是因为它已经能妥善解决问题，与其免费维护，我更愿意通过收费来维护它。

不同之处：

• 支持任何 IMAP/SMTP 提供商 — Gmail、Hostinger、Fastmail、iCloud、Outlook 365、Proton（通过 Bridge）、Yahoo、Zoho、自定义域名，以及任何支持该协议的服务。
• 在一个配置中管理多个账户 — 通过环境变量声明任意数量的账户，每次工具调用都接受 account 参数。一个服务实例即可连接所有账户。
• 15 个达到生产级别的工具 — 列出、搜索、读取邮件、查看邮件会话、处理附件、发送、创建草稿、移动、复制、删除、标记和文件夹增删改查。常用操作一应俱全。
• 可自托管，凭据绝不会离开你的设备 — 通过 npm 在本地运行，或在 Docker 中运行。MCP 端点采用 Bearer 令牌身份验证。无遥测数据，无 SaaS 代理。
• 只需一个 .env 文件 — 无需繁琐的 OAuth 流程、服务账户 JSON 或 Google Cloud 项目。在提供商端生成应用专用密码，填入文件即可。

---

购买后你将获得

在 Gumroad 结账后，你可以下载一个 zip 文件，其中包含：

• 服务端的完整 TypeScript 源代码（Node 20+、@modelcontextprotocol/sdk、imapflow、nodemailer）
• 可直接运行的 Dockerfile + docker-compose.yml
• 带完整模板和行内注释的 .env.example
• 扩展版 README，包含安装说明、Claude Code 接入、通过 Caddy 进行生产环境部署以及故障排除
• 永久商业许可证（完整条款请参阅 LICENSE — 可用于不限数量的商业用途，不得转售；如果不适合你，可在首日内退款）
• 1.x 主版本内免费的补丁和次要版本更新

结账后首次调用工具的预计耗时：如果已生成提供商的应用专用密码，则约为 5 分钟。

---

Provider 矩阵

我每天使用 Hostinger 和 Gmail。其他提供商的设置也已记录并经过测试。

Provider	身份验证	IMAP 主机	SMTP 主机	备注
Hostinger	邮箱密码	imap.hostinger.com:993	smtp.hostinger.com:465	我用它处理 [email protected] 的邮件。在 mail-tester.com 上得分 10/10。
Gmail / Workspace	应用专用密码	imap.gmail.com:993	smtp.gmail.com:465	请先启用 2FA。Workspace 管理员可以在组织级别停用 IMAP。
Fastmail	应用专用密码	imap.fastmail.com:993	smtp.fastmail.com:465	实现简洁，没有意外。
iCloud Mail	应用专用密码	imap.mail.me.com:993	smtp.mail.me.com:587	SMTP 使用 587/STARTTLS。
Outlook 365	应用专用密码	outlook.office365.com:993	smtp.office365.com:587	某些租户会停用 SMTP AUTH。个人账户始终可用。
Proton Mail	通过 Proton Bridge	127.0.0.1:1143	127.0.0.1:1025	Bridge 必须在本地运行。
Yahoo Mail	应用专用密码	imap.mail.yahoo.com:993	smtp.mail.yahoo.com:465	在账户安全设置中创建应用专用密码。
Zoho Mail	应用专用密码（或普通密码）	imap.zoho.eu:993 / .com	smtp.zoho.eu:465 / .com	欧盟和美国租户使用不同的主机。
通用	应用专用密码或普通密码	视情况而定	视情况而定	任何符合 RFC 标准的服务都可以使用。

各提供商的完整设置说明见 docs/CONFIG.md。

---

15 个工具

所有工具都需要 account 参数，即你在 .env 中声明的 ID。适用时，文件夹默认使用 INBOX。

阅读（6 个）

工具	用途
email_list_folders	列出所有 IMAP 文件夹及未读数量
email_list_messages	列出文件夹中的邮件，支持分页和未读筛选
email_search_messages	按发件人、主题、正文、日期或是否有附件进行搜索
email_get_message	按 UID 获取完整邮件正文（纯文本 + HTML + 附件元数据）
email_get_attachment	获取附件内容（UTF-8 或 base64）
email_get_thread	根据 Message-ID / In-Reply-To / References 重建对话线程

写入（2 个）

工具	用途
email_send_message	通过 SMTP 发送邮件，并通过 IMAP 将副本保存到 Sent 文件夹
email_create_draft	在 Drafts 文件夹中创建草稿

管理（7 个）

工具	用途
email_move_message	将邮件移至另一个文件夹
email_copy_message	将邮件复制到另一个文件夹
email_delete_message	将邮件移至 Trash（默认），或标记为 \Deleted 并彻底删除
email_mark_message	设置或取消 \Seen / \Flagged / \Answered 标记
email_create_folder	创建 IMAP 文件夹
email_rename_folder	重命名 IMAP 文件夹
email_delete_folder	删除 IMAP 文件夹

---

如何连接到 Claude Code

安装后（安装流程包含在压缩包中），将以下内容添加到项目的 .mcp.json 或全局配置 ~/.claude.json 中：

{
  "mcpServers": {
    "email": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_AUTH_TOKEN"
      }
    }
  }
}

重启 Claude Code（运行 /mcp 确认服务状态为 connected），然后试试：

“列出账户 main 中最近 5 封未读邮件。”

或者，使用多账户进行高级操作：

“搜索账户 support 中过去 7 天里来自 [email protected] 的未回复邮件，概述这些邮件，并在账户 main 中起草回复。”

---

定价

一次性支付 $49。 永久商业许可证，业务使用不限，不收取周期性费用。

如果不适合你的设置，可在当天退款。购买后 24 小时内发送邮件至 [email protected]，我会为你办理退款（如果你发信时我正在睡觉，我会在次日上午处理）。

在 Gumroad 上购买

---

限制与范围（有意为之）

• 身份验证：仅支持应用密码或普通密码。不支持 OAuth 2.0。这样可使服务保持无状态，且不依赖特定提供商。
• 传输方式：仅支持 HTTP（不支持 stdio）。通过 HTTP 使用 MCP 是唯一支持远程 Agent 和共享基础设施的模式。
• 文件夹名称：默认使用 INBOX、Sent、Drafts 和 Trash。对于使用 INBOX.Sent 这类前缀的服务器，会通过回退机制处理。自定义名称需要少量代码更改。
• 附件下载：二进制附件上限为 1 MB（以 base64 返回）。文本附件（text/*、JSON、XML、ICS）不设上限。
• HTML 正文：在 email_get_message 中，超过 25,000 个字符的部分会被截断。文本正文始终完整发送。

---

路线图（1.0 之后，尚未承诺）

• 为每个账户提供可选的 SENT_FOLDER / DRAFTS_FOLDER / TRASH_FOLDER 环境变量覆盖
• 为 Gmail 和 Microsoft 提供 OAuth 流程（独立的附加组件，不捆绑提供）
• 收到邮件时发送 Webhook（面向 Agent 的推送式通知）
• 日历/ICS 桥接（独立产品，可无缝集成）
• 通过 Anthropic API 实现 AI 自动标记

欢迎通过邮件投票——你希望接下来实现什么？[email protected]。

---

许可证

商业许可证——请参阅 LICENSE。

简而言之：购买后可无限制地用于个人和商业用途，但不得转售或再分发源代码。

---

支持

• 错误报告和功能请求：发送邮件至 [email protected]，并附上清晰的复现步骤。
• 许可证问题和批量定价：请联系同一邮箱。
• 公开变更日志：CHANGELOG.md。

由 OneShotForge 打造。