Better Email MCP

更好的电子邮件MCP

mcp名称：io.github.n24q02m/better-email-mcp

用于AI代理的IMAP/SMTP电子邮件服务器——6个具有多帐户和自动发现功能的复合工具

  ](https://www.npmjs.com/package/@n24q02m/better-email-mcp) ](https://hub.docker.com/r/n24q02m/better-email-mcp) 

 ](#)   

Sister projects from n24q02m (click to expand)

目录

• 特性
• 状态
• 文档
• 工具
• 远程（HTTP模式）
• Outlook OAuth设备代码（HTTP模式）
• 配置
• 安全
• 从源代码构建
• 信任模型
• 许可证

特性

• 多账户支持 --管理6个以上的电子邮件帐户（Gmail、Outlook、Yahoo、iCloud、Zoho、ProtonMail、自定义IMAP）
• 应用程序密码 --大多数提供商不需要OAuth2设置；克隆并在1分钟内运行
• 6个复合工具 有20个操作——在单个通话中搜索、读取、发送、回复、转发、组织、设置凭据
• 自动发现 --从电子邮件地址检测到提供商设置，支持自定义IMAP主机
• 线程感知 --reply/forward维护In reply To和References标头
• 分层令牌优化 --压缩描述+按需 help 工具+MCP资源

状态

2026-05-02——架构稳定更新 过去几个月，凭证处理和守护进程桥自动生成模式发生了重大变化。这导致了多进程竞争、浏览器标签垃圾邮件和插件之间不一致的设置用户体验。 从v\开始，架构是稳定的：2种干净模式（stdio+HTTP），没有守护进程桥层，没有从stdio自动生成。 为不稳定时期道歉。如果您在以前的版本中遇到问题，请更新到v\+并遵循当前版本 docs/setup-manual.md --不再需要大多数先前的解决方法。 来自同一作者的相关插件: - 湿mcp --网络搜索+内容提取 - mnemo mcp --持久AI记忆 - 想象一下mcp --图像/视频理解+生成 - 更好的概念mcp --API通知 - 更好的电子邮件mcp --电子邮件管理 - 更好的电报mcp --电报 - 更好的godot-mcp --Godot引擎 - 更好的代码审查图 --代码审查知识图 所有插件共享相同的架构——安装一次，学习模式转换。

文档

完整文档请访问 mcp.n24q02m.com/servers/better-email-mcp/:

• 设置 --Claude Code、Codex、Gemini CLI、Cursor、Windsurf、mcp.json的安装方法
• 模式概述 --stdio/本地中继/远程中继/远程oauth
• 多用户设置 --根据JWT子证书模型

使用AI代理进行安装 --将此粘贴到您的AI编码代理：

安装MCP服务器 better-email-mcp 按照以下步骤 https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-email-mcp/setup-with-agent.md

工具

MCP资源

远程（HTTP模式）

以具有OAuth 2.1身份验证的多用户HTTP服务器运行：

{
  "mcpServers": {
    "better-email": {
      "type": "http",
      "url": "https://better-email-mcp.n24q02m.com/mcp"
    }
  }
}

自托管（HTTP模式）

单用户模式（应用密码提供商的中继表单+捆绑的Outlook OAuth设备代码）：

docker run -p 8080:8080 \
  -e PUBLIC_URL=https://your-domain.com \
  -e DCR_SERVER_SECRET=$(openssl rand -hex 32) \
  n24q02m/better-email-mcp:latest

用户通过OAuth流/粘贴表单提供自己的电子邮件凭据。无需服务器端 EMAIL_CREDENTIALS 需要。Outlook OAuth使用捆绑的公共Azure客户端(d56f8c71-9f7c-43f4-9934-be29cb6e77b0Thunderbird模式）——无需用户端Azure应用程序注册。

Outlook OAuth设备代码（HTTP模式）

在HTTP模式下，Outlook/Hotmail/Live帐户会自动使用OAuth2设备代码。首次使用时：

1. 服务器打印设备代码和Microsoft登录URL
2. 在浏览器中打开URL并输入代码
3. 登录并授权应用程序
4. 令牌按JWT子持久化(tokens/.json)

OAuth使用捆绑的公共Azure客户端(d56f8c71-9f7c-43f4-9934-be29cb6e77b0Thunderbird模式）——无需用户端Azure注册。

在 stdio模式，Outlook帐户使用 应用程序密码 改为（Outlook帐户设置→ 安全→ 高级安全选项→ 应用程序密码）。

配置

多个帐户

EMAIL_CREDENTIALS=user1@gmail.com:pass1,user2@outlook.com:pass2,user3@yahoo.com:pass3

自定义IMAP主机

EMAIL_CREDENTIALS=user@custom.com:password:imap.custom.com

搜索查询语言

支持的提供商

安全

• 凭证净化 --密码从未在错误消息中泄露
• 应用程序密码 --使用特定于应用程序的密码，而不是常规密码
• 令牌存储 --保存了600个权限的Outlook OAuth令牌
• IMAP验证 --执行前已验证搜索查询

从源代码构建

git clone https://github.com/n24q02m/better-email-mcp.git
cd better-email-mcp
bun install
bun run dev

信任模型

此插件实现 TC NearZK （在记忆中，转瞬即逝）。看 mcp核心/docs/TRUST-MODEL.md 进行全面分类。

许可证

麻省理工学院——见 许可证.