mailbridge

Mailbridge MCP

将你的 AI 助手连接到电子邮件——读取、搜索、发送、回复、整理、撰写草稿、安排发送时间，以及管理来自 iCloud 或任何 IMAP 账户的附件。适用于 Claude、OpenAI Codex、Cursor、Windsurf 和任何兼容 MCP 的客户端。

凭据安全地存储在操作系统的凭据存储中（macOS Keychain、Windows Credential Manager 或 Linux Keyring），绝不会存储在文件中。

---

功能

读取与搜索

• 读取电子邮件 — 获取收件箱或任意文件夹中的邮件，以及主题、发件人和日期
• 收件箱摘要 — 智能摘要，包含优先级评分、分类和操作建议
• 搜索 — 按关键词、发件人或主题查找邮件
• 会话视图 — 查看任意邮件的完整对话线程
• 联系人历史记录 — 查看与特定联系人之间的所有邮件
• 统一收件箱 — 将多个文件夹合并为按日期排序的视图
• 优先级评分 — 自动为每封邮件评定 1–5 分的紧急程度
• 自动分类 — 自动为邮件添加“财务”“旅行”“日历”“新闻简报”等标签

发送与草稿

• 发送与回复 — 撰写新邮件或以线程形式回复
• 发送附件 — 为任意待发送邮件附加本地文件或内嵌内容
• 智能草稿 — 在本地保存邮件，供发送前审核
• 邮件定时发送 — 安排邮件在未来时间发送
• 阅读回执 — 可选请求确认已发送邮件是否被打开（取决于收件人；请参阅阅读回执）

整理

• 批量操作 — 通过一条命令标记、移动或删除多封邮件
• 跟进提醒 — 为邮件添加“3 天后提醒我”标签，该邮件便会出现在下一份摘要中
• 取消订阅 — 通过 List-Unsubscribe 标头自动取消邮件列表订阅
• 邮件规则 — 定义本地规则，自动标记、分类或设定邮件优先级
• 移动、删除、标记 — 标准收件箱管理工具

附件与内容

• 读取附件 — 支持 PDF、DOCX、TXT、JPG、PNG、MP3、MP4 等格式
• 附件安全 — 下载前扫描每个附件；阻止危险文件类型
• 导出邮件 — 将任意邮件导出为简洁的 Markdown
• 日历信息提取 — 从邮件和 .ics 文件中提取事件详情（日期、时间、地点）

账户

• 多个账户 — 连接并在多个账户之间切换
• 安全凭据 — 密码存储在操作系统密钥链中，绝不以明文形式保存

---

安装

Claude Cowork

1. 前往 Customize → Connectors → Browse Plugins → "+" sign
2. 添加市场来源：https://github.com/Creativestefan/mailbridge-mcp
3. 开始新的聊天，然后输入 Open Mailbridge setup，打开设置门户并连接你的电子邮件账户
4. 使用 iCloud 邮件时，你需要创建一个App specfic password 来安全访问电子邮件。使用真实密码将无法通过身份验证。
5. 随时重新打开设置："open Mailbridge setup"

之后更新： Customize → Connectors → Browse Plugins → (...) button and Click Check for update

---

OpenAI Codex

1. 添加 Mailbridge 市场：

codex plugin marketplace add Creativestefan/mailbridge-mcp --ref main

2. 安装插件：

codex plugin add mailbridge@mailbridge

3. 开始新的 Codex 对话线程并测试：

Use Mailbridge to check my email connection.

4. 如果尚未连接账户：

Type "Open Mailbridge setup" and send.

设置门户会将凭据直接保存到操作系统的凭据存储中（macOS Keychain、Windows Credential Manager 或 Linux Keyring）。

之后更新：

codex plugin marketplace upgrade
codex plugin add mailbridge@mailbridge

---

Cursor

1. 打开 Cursor Settings → Tools & MCP
2. 点击 Add MCP Server 并粘贴：

{
  "mcpServers": {
    "mailbridge": {
      "command": "npx",
      "args": ["-y", "mailbridge-mcp@latest"]
    }
  }
}

3. 完全退出并重新打开 Cursor（MCP 服务仅在启动时加载）
4. 开始新的聊天并测试：

Use Mailbridge to check my email connection.

如果尚未连接账户，设置门户会自动打开；也可以询问："open email setup"。

之后更新： 将配置中的版本标签更新为 mailbridge-mcp@latest，它会始终获取最新版本。

---

通过 npm（任何 MCP 客户端）

添加到 MCP 客户端配置中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "mailbridge": {
      "command": "npx",
      "args": ["mailbridge-mcp"]
    }
  }
}

首次启动时，如果尚未配置账户，设置门户会自动在浏览器中打开。填写邮箱信息后，凭据会直接保存到操作系统的凭据存储中，门户随后关闭。只需设置一次。

如需随时重新打开设置，请对助手说：“open email setup”

---

设置

首次安装时，浏览器会自动打开一个表单，用于连接邮箱账户。提交后，凭据会直接保存到操作系统的凭据存储中，不会写入文件。

如需随时重新打开设置，只需对助手说：“open email setup”。

iCloud

你必须使用 App-Specific Password，主 Apple ID 密码无法使用。

前往 account.apple.com → Sign-In & Security → App-Specific Passwords → +，将其命名为“Mailbridge”，并使用生成的密码。

自定义 IMAP 账户

使用完整的邮箱地址和密码。邮件服务器通常是 mail.yourdomain.com——如果不确定，请查看邮箱服务提供商的设置。

---

工具

阅读

工具	描述
check_connection	测试连接并显示收件箱统计信息
read_emails	从任意文件夹获取邮件（包括优先级和类别）
get_email_body	根据 UID 获取邮件的完整正文
get_emails_with_preview	获取邮件及正文摘要片段——用于收件箱摘要
search_emails	按关键词、发件人或主题搜索
list_folders	列出所有邮箱文件夹
get_thread	获取邮件的完整对话线程
get_contact_history	获取与特定联系人的所有往来邮件
unified_inbox	将多个文件夹合并为一个排序视图
export_email	将邮件导出为整洁的 Markdown
extract_calendar_events	提取事件详情并解析 .ics 附件

附件

工具	描述
get_attachments	列出附件并进行安全扫描——不下载
read_attachment	经用户批准后下载并读取附件

发送和草稿

工具	描述
send_email	撰写并发送新邮件（可选附加文件）
reply_to_email	回复现有邮件（可选附加文件）
save_draft	将邮件保存为本地草稿
list_drafts	列出已保存的草稿
send_draft	根据 ID 发送已保存的草稿
delete_draft	丢弃已保存的草稿
schedule_email	预约在未来时间发送邮件
list_scheduled	列出待发送的预约邮件
cancel_scheduled	取消预约邮件
check_email_opens	扫描收件箱以查找已读回执确认，并报告邮件打开情况
list_tracked_emails	显示已跟踪的邮件及其打开状态（不扫描收件箱）

管理

工具	描述
mark_as_read	将邮件标记为已读
mark_as_unread	将邮件标记为未读
move_email	将邮件移至其他文件夹
delete_email	将邮件移至废纸篓
bulk_mark_read	将多封邮件标记为已读
bulk_mark_unread	将多封邮件标记为未读
bulk_move	将多封邮件移至某个文件夹
bulk_delete	将多封邮件移至废纸篓
set_reminder	为邮件设置跟进提醒
list_reminders	查看有效提醒（逾期提醒会特别标出）
complete_reminder	将提醒标记为已完成
unsubscribe_email	通过 List-Unsubscribe 标头自动退订

规则

工具	描述
add_rule	添加本地规则，用于标记、分类或设置邮件优先级
list_rules	列出所有已配置的规则
remove_rule	按名称移除规则
apply_rules	对一组邮件试运行规则

账号

工具	描述
list_accounts	显示所有已连接的账号
switch_account	切换当前账号
add_account	通过聊天添加新账号
remove_account	移除一个账号（默认为当前账号）
remove_all_accounts	断开连接并移除所有账号
open_setup	打开设置门户以连接或添加账号

---

收件箱摘要

向助手询问 “帮我总结一下” 或 “我错过了什么？”，即可获取结构化摘要。

每封邮件现在都会自动进行 优先级评分（1–5）并添加 类别标签，让摘要即时完成分类：

• 🔴 需要处理 — 优先级为 4–5，或包含“紧急”“截止日期”“需要回复”等关键词
• 💰 财务与账单 — 发票、付款、订阅续订
• 📅 活动与日历 — 会议邀请、旅行确认、RSVP
• 📦 更新与供参考 — 新闻简报、通知、低优先级邮件

今天到期或已逾期的 跟进提醒 会显示在每份摘要的顶部。

摘要末尾会附上 建议操作区块，列出具体的后续步骤，例如“取消订阅 X”“为 Y 设置提醒”或“批量归档 8 封新闻简报”。

---

草稿与定时发送

发送前，将任何邮件保存为草稿：

“为这封邮件起草一封回复——我会先检查”

定时发送邮件：

“明天上午 9 点把这封邮件发给 [email protected]”

定时邮件会在设定时间之后的下次会话启动时自动发送。

---

已读回执

让 Mailbridge 跟踪已发送邮件何时被打开：

“把这封邮件发给 [email protected]，并在他打开时告诉我”

这会设置 request_receipt: true，在邮件中添加标准的 已读回执标头（RFC 8098 / MDN）。之后：

“John 打开我的邮件了吗？”

会运行 check_email_opens，在收件箱中查找收件人的确认邮件，并报告谁打开了邮件以及打开时间。

实际工作方式及其限制：

• Mailbridge 使用 已读回执标头，而非跟踪像素。不会向任何服务发送数据；收件人的邮件应用会询问对方是否确认，确认信息会以普通邮件的形式返回，由 Mailbridge 在本地读取。
• 只有当收件人的客户端 支持 已读回执，且收件人 同意 发送时，才会收到回执。Apple Mail 和 Thunderbird 会提示用户；Gmail 网页应用会忽略此请求。
• 没有收到回执，并不意味着邮件未被阅读。“等待中”状态仅表示尚未收到确认，并不能证明任何情况。
• 这种方式有意尊重隐私：没有隐形像素、没有第三方跟踪器，也不会有数据离开你的设备。

---

邮件规则

定义本地规则，在收件箱摘要期间自动应用：

“将来自 [email protected] 的所有邮件标记为紧急” “将来自 [email protected] 的所有邮件归类为财务” “将主题中包含 ‘invoice due’ 的邮件优先级设为 5”

规则存储在本地，无需任何服务端过滤即可生效。

---

附件

Mailbridge 会在下载前扫描每个附件：

安全状态	含义
✅ 安全	已知安全的文件类型，扩展名与 MIME 类型匹配
⚠️ 警告	扩展名无法识别或 MIME 类型不匹配——不会自动下载
🚫 已拦截	可执行文件或脚本文件——直接拒绝（.exe、.bat、.ps1、.sh、.jar 等）

支持的文件类型：

类型	处理方式
PDF	提取并显示文本
DOCX	提取并显示文本
TXT、CSV、MD	以纯文本形式显示
JPG、PNG、GIF、WebP	内嵌显示——AI 可以查看并描述图像
MP3、MP4、WAV、M4A	保存到临时路径——传递给转录插件

---

支持的服务提供商

服务提供商	IMAP	SMTP
iCloud	imap.mail.me.com:993	smtp.mail.me.com:587
自定义 IMAP	你的邮件服务	你的邮件服务

---

安全

• 密码仅存储在操作系统凭据库中，绝不会写入任何文件
• 设置门户是一个一次性浏览器表单——启动后会收集你的凭据，将其保存到操作系统钥匙串中，然后自动关闭
• 所有 IMAP 和 SMTP 连接均使用 SSL/TLS
• 附件在下载前会经过扫描——可执行文件和脚本一律会被拦截
• 不会向任何 Mailbridge 服务发送数据——所有操作都在你的设备上本地运行

---

许可证

MIT — 参见 LICENSE

---

法律声明

• 隐私政策
• 使用条款