googlarz/proton-mail-bridge-client

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

84 stars 19 forks 质量 89 趋势 36MIT

Repository Install

🌉 通过Proton Bridge本地优先的Proton Mail MCP和CLI。通过Claude Desktop或终端搜索、阅读、草拟、发送、同步并操作邮件。

概览

让 Claude Desktop（或 Cline，或任何 MCP 客户端）完全访问您的 Proton Mail 收件箱：阅读、搜索、发送、草拟、分流线程、管理文件夹、保存附件等——共 95 个 MCP 工具。大部分相同的功能也作为完整的 CLI 支持脚本编写、cron 和管道自动化——无需 Claude。完整的邮箱回填系统对真实账户进行了端到端验证，该账户涵盖62个文件夹/标签，包含57,000+条索引邮件——其中包括一个包含22,800条邮件的归档文件夹，逐窗口填充，且在重启、暂时的IMAP断线和连接超时期间均无数据丢失。

概述（AI 翻译）

让 Claude Desktop（或 Cline，或任何 MCP 客户端）完全访问您的 Proton Mail 收件箱：阅读、搜索、发送、草稿、排序线程、管理文件夹、保存附件等——总共 116 个 MCP 工具。大部分相同的功能也作为完整的 CLI 支持脚本编写、cron 和管道自动化——无需 Claude。

也用Proton Drive吗？ 参见 proton-drive-mcp，Proton Drive 的配套 MCP 服务器和 CLI（上传、下载、共享和管理 Claude 加密文件）。将两者并排运行，以便一次对话处理邮件和文件，比如从这里保存附件，然后上传到 Drive。相关项目中会有更多内容。

大规模实战测试（v2.0.0）: 完整的邮箱回填数据，端到端验证，真实账户中有57,000+条索引邮件，涵盖62个文件夹/标签——其中包括一个包含22,800条邮件的归档文件夹，从零开始填充，逐个UID窗口填充，重启、暂时IMAP断线和连接超时均无数据丢失。

快速开始（2分钟）

没有终端？ 不如按照逐步指南操作。

安装并登录Proton Mail Bridge，并保持运行状态。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

  ____  ____   ___ _____ ___  _   _   __  __    _    ___ _
 |  _ \|  _ \ / _ \_   _/ _ \| \ | | |  \/  |  / \  |_ _| |
 | |_) | |_) | | | || || | | |  \| | | |\/| | / _ \  | || |
 |  __/|  _ <| |_| || || |_| | |\  | | |  | |/ ___ \ | || |___
 |_|   |_| \_\\___/ |_| \___/|_| \_| |_|  |_/_/   \_\___|_____|
  Bridge Client  ·  CLI + Claude Desktop MCP for Proton Mail

Give Claude Desktop (or Cline, or any MCP client) full access to your Proton Mail inbox: read, search, send, draft, triage threads, manage folders, save attachments, and more — 116 MCP tools in total. Most of the same capabilities are also available as a full CLI for scripting, cron, and piped automation — no Claude required.

Using Proton Drive too? See proton-drive-mcp, the companion MCP server and CLI for Proton Drive (upload, download, share and manage your encrypted files from Claude). Run both side by side to handle mail and files in one conversation, for example save an attachment from here, then upload it to Drive. More in Related projects.

Battle-tested at scale (v2.0.0): full mailbox backfill validated end-to-end against a real account with 57,000+ indexed messages across 62 folders/labels — including a 22,800-message Archive folder backfilled from scratch, UID-window by UID-window, with zero data loss across restarts, transient IMAP disconnects, and connection timeouts.

Quick start (2 minutes)

在 GitHub 查看完整 README

安装

docker run -i --rm --network host \

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "proton-mail-bridge": {
      "command": "proton-mail-bridge-mcp",
      "env": {
        "PROTONMAIL_USERNAME": "[email protected]",
        "PROTONMAIL_PASSWORD": "your-bridge-password",
        "PROTONMAIL_IMAP_HOST": "127.0.0.1",
        "PROTONMAIL_IMAP_PORT": "1143",
        "PROTONMAIL_IMAP_SECURE": "false",
        "PROTONMAIL_SMTP_HOST": "127.0.0.1",
        "PROTONMAIL_SMTP_PORT": "1025"
      }
    }
  }
}