Proton Mail (Bridge)

proton-mail-mcp

一个 MCP 服务，可让 AI 助手阅读你的 Proton Mail、撰写草稿并整理邮箱；在移动、删除或发送邮件前，会先提供预览供你批准。它运行在你自己的电脑上，使用与 Proton Mail Bridge 相同的登录信息，并且只监听 127.0.0.1。

proton-mail-mcp 是非官方项目，与 Proton AG 无关联，也未获其认可。

uvx mcp-proton-mail setup

在你自己的终端中运行。 安装 说明了你需要预先准备什么、它会请求什么，以及如何将此服务添加到 MCP 客户端。

功能

• 搜索和阅读。 搜索和统计邮件、阅读完整邮件会话，以及阅读或保存附件。不会将任何邮件标记为已读。
• 撰写草稿。 创建新草稿、回复和转发邮件。草稿会保持未发送状态，直到你发送为止。
• 整理邮箱。 移动、归档、移至垃圾箱、标记为已读或未读、添加或移除标签、取消订阅、删除草稿和创建文件夹；每项操作都会先提供预览供你批准。如果你启用文件夹规则（测试版），也可以使用它们。
• 按需启用发送。 默认关闭发送功能，而且必须先保存草稿并获得批准才能发送。
• 在聊天中显示邮件。 支持 MCP Apps 的客户端可显示邮件会话视图、撰写器和发送审核界面。其他客户端则会以文本形式提供相同结果。

它还会在本地维护一份私有邮件标头索引，以加快搜索速度。索引不包含邮件正文。

它如何保护你的邮件安全

读取不会改变任何内容。 搜索和读取会以只读方式打开邮箱，绝不会将邮件标记为已读。

修改邮件分两步进行。

1. 预览。 助手会询问某项修改会产生什么影响，此时不会做任何更改。它会显示数量、示例和目标，并获取一个 令牌：该令牌只能使用一次、有效期很短，且仅绑定到这些确切的邮件。执行前，服务端会再次检查这些邮件；如果有任何不同，就会拒绝操作。新邮件绝不会被悄悄纳入审批范围。
2. 确认。 你的 MCP 客户端会显示一份包含确切修改内容的表单，由你选择接受或拒绝。只有令牌并不足够，拒绝操作会使令牌失效。表单的可靠性取决于客户端：会自动填写表单的客户端会使这项检查失效。

操作	所需条件	能否撤销？
搜索、计数、读取、列出	无	无需撤销
保存草稿或附件	无；绝不会发送，且始终记录日志	已保存的项目会一直保留，直到你将其移除
移动、移至废纸篓、归档、标记为已读或未读、标签、文件夹规则（启用时）	预览、令牌、表单	可以，使用 undo_action
取消订阅	预览、令牌、表单	不可以。启用发送功能时，mailto 目标只会创建尚未发送的草稿，且需要单独审批发送；关闭发送功能时，不会使用 mailto 目标
删除草稿	预览、令牌、表单	不可以，操作永久生效
创建文件夹、保存规则（启用时）	预览、令牌、表单	不可以，需手动移除
重建本地搜索索引	预览、令牌；无需表单，因为不会修改邮件	不可以
发送草稿	默认关闭；启用后需要预览、令牌，以及表单或输入 OK	不可以
创建 Sieve 过滤器（启用规则时）	仅需预览。它始终会拒绝操作，因为 Bridge 无法应用过滤器	不会发生任何更改
撤销已记录的修改	undo_action：无需令牌或表单，每项修改只能撤销一次，且始终记录日志	不适用

永久删除操作只会影响 Drafts 中已批准的邮件；移除标签只会删除该标签下的副本。没有用于清空 Trash、删除邮箱或重命名邮箱的工具。每次写入操作都会记入只追加的审计日志，其中不包含邮件正文、主题、完整地址或令牌。

发送

设置 PROTON_MCP_ENABLE_SEND=1 以添加发送工具，并设置 PROTON_MCP_SEND_FROM（你用于发送邮件的地址）和 PROTON_BRIDGE_CERT（Bridge 的证书）；未设置这些值时，预览会拒绝操作。

不支持自由输入内容发送：流程为 create_draft，然后 preview_send，再到 send_draft；预览后如有任何编辑，操作都会被拒绝。支持表单的客户端会向你显示表单。对于声明不支持表单的客户端，助手会向你显示纯文本摘要，并在你于聊天中输入 OK 后发送。服务端无法证明 OK 是由人输入的： 只有助手会报告这一点，因此被误导的助手可能会在没有询问的情况下发送。设置 PROTON_MCP_SEND_TYPED_OK=0 可关闭此流程。 审批如何运作中有详细说明。

邮箱修改不支持输入 OK。如果客户端不支持表单，操作会被拒绝；除非你有意设置 PROTON_MCP_CONFIRM_MUTATIONS=0，此时仅凭令牌即可授权修改。

受保护的发件人

PROTON_MCP_PROTECTED_CONFIG 可指定一份本地发件人名单；清理、取消订阅、删除草稿和规则操作不得触及名单中的发件人。项目不会随附任何名单，因此默认情况下，来自银行或朋友的邮件与其他邮件一样，都可以获批。 名单会检查正在操作的邮件是谁发送的，而不会检查草稿的收件人是谁。请参阅受保护的发件人。

默认关闭

功能	设置
发送	PROTON_MCP_ENABLE_SEND=1，并设置 PROTON_MCP_SEND_FROM 和 PROTON_BRIDGE_CERT
不显示自有地址的表单	PROTON_MCP_SEND_SELF_NO_FORM=1
对指定客户端输入确认文字	PROTON_MCP_SEND_TYPED_OK_CLIENTS
受保护的发件人	PROTON_MCP_PROTECTED_CONFIG
新邮件监视器	PROTON_MCP_IMAP_IDLE_ENABLED=1
后台索引同步	PROTON_MCP_BACKGROUND_SYNC_ENABLED=1
文件夹规则和 Sieve 过滤器（测试版）	PROTON_MCP_ENABLE_RULES=1
规则定时器	需要自行安装的 Linux 定时器；没有工具可以启动它

默认开启：确认表单、启用发送后所需的确认文字、MCP Apps 视图，以及启动时的索引恢复。配置列出了每项设置。

安装

你需要：

• 付费的 Proton 方案，这是 Bridge 的运行要求。
• Linux（Debian/Ubuntu、Fedora/RHEL 或 Arch）或 macOS；除非已安装 Bridge，否则还需要Homebrew。原生 Windows 支持是新推出的，目前仅在 Windows Server 运行器上运行过：请先阅读 docs/windows.md，或使用 WSL2。
• uv。如果你尚未安装 Python，它会一并安装 Python 3.12 或更高版本。

PyPI 上的软件包是 mcp-proton-mail，uvx 会获取并运行它；无需克隆任何内容。其命令是 proton-mail-mcp，也会安装为 mcp-proton-mail。

1. 退出 Proton Mail Bridge 应用（如果正在运行），并关闭其登录时启动设置。设置程序会将 Bridge 作为后台服务运行，不能与应用同时运行；应用中的登录状态会保留。如果你想继续使用应用，请在下方添加 --skip-bridge-service。

2. 在你自己的终端中运行引导式设置，并指定你的 MCP 客户端：

uvx mcp-proton-mail setup --client claude-desktop
# or claude-code, chatgpt, codex, gemini, cursor, grok-bot; repeatable

设置程序会展示执行内容、询问相关问题、打印完整计划，并且在你批准前不会更改其他内容（--dry-run 会在计划阶段停止）。唯一例外是：如果已安装 Bridge，但设置程序尚不知道你的账户信息，它会先询问是否以 [Y/n] 打开 Bridge 的 CLI，让你登录 Bridge。它会检查或安装 Bridge，将 Bridge 密码和新的 bearer token 存入系统凭据存储，启动用户级服务，检查服务端能否读取收件箱，并将服务端添加到你的客户端，同时备份其配置。大多数客户端会启动 proton-mail-mcp connect，由它自行读取 token，因此客户端配置中不会保存 token。token 绝不会显示出来。重复运行是安全的。如果在 Debian 或 Ubuntu 上因为缺少 python3-venv 而停止，请运行 sudo apt-get install python3-venv，或在 uvx 后添加 --managed-python。

这些操作只有你能完成，设置程序会在需要时告知你：

• 登录 Bridge（如果尚未登录）：设置程序会打开 Bridge 的 CLI，你需要在其中输入 login、Proton 邮箱和密码，以及双重验证代码，并在浏览器中打开它打印的任何验证链接。可以粘贴内容。随后，设置程序会从 Bridge 读取你的 IMAP 用户名。
• 在隐藏提示符下输入 Bridge 密码：这是 Bridge 生成的密码，不是你的 Proton 密码。在 Proton Mail Bridge 应用中，选择你的邮箱，打开 Mailbox details，然后复制 Password 下方的密码；Bridge 的 CLI 可通过 info 显示该密码。这就是设置程序必须在你自己的终端中运行的原因。在经典版 PowerShell 或 cmd 中，通常无法在隐藏提示符下粘贴内容。请使用 Windows Terminal 并按 Ctrl+Shift+V 粘贴，或手动输入密码。如果之后某个工具提示 Mailbox authentication failed，错误信息会指出要运行的设置命令。
• 在 macOS 上，按提示允许访问 Keychain：选择 Always Allow。
• 按照设置程序的提示，在最后重启客户端。

3. 检查。 询问你的助手有哪些 Proton Mail 工具；它应当列出 search_mail 等工具。

之后运行 uvx mcp-proton-mail configure-client --client <name> 可添加其他客户端；连接 MCP 客户端介绍了各个客户端，也涵盖其他内容。替你完成设置的 AI Agent 可按照 llms-install.md 操作：它会完成其余所有步骤，只需将 Bridge 登录这一步交给你，并以一条供你在自己终端中运行的命令提供。

文档

• 初次使用：入门指南介绍如何完成首次会话。
• 设置：安装、连接 MCP 客户端、 配置和 Windows。
• 查找信息：工具参考和 结果、拒绝与限制。
• 了解其工作原理：审批机制，以及包含所有页面的 文档索引。
• 变更内容：更新日志。

在 PyPI 上，这些相对链接无法解析；请在 代码仓库中阅读。

面向 AI 助手和编码 Agent

• 连接到此服务的助手无需从此代码仓库获取任何内容：服务会在连接时向它提供指令和工具描述。
• 阅读此项目介绍的助手可以从 llms.txt 开始，这是这些文档的 Markdown 索引。
• 替他人安装此项目的助手应按照 llms-install.md 操作，其中会将唯一只能由本人完成的步骤交给用户。
• 要修改此代码仓库的编码 Agent应阅读 AGENTS.md。

隐私政策

proton-mail-mcp 仅在你的计算机上运行，不会收集遥测数据，也不会向其作者发送任何内容。 PRIVACY.md 是隐私政策，说明它会读取什么、将内容保存在何处以及如何删除、哪些发送操作无需审批，以及哪些内容会发送给 MCP 客户端的模型提供商。

网络连接

PRIVACY.md 列出了 proton-mail-mcp 建立的所有连接，包括运行期间、客户端每次启动插件或程序包时，以及安装和设置期间建立的连接。

许可证

Apache-2.0。