Protonmail MCP服务器

一个免费开源的模型上下文协议(MCP)服务器,允许AI助手如Claude管理您的Protonmail收件箱,通过自然语言进行邮件清理、标记、发送等操作。

  • by jagjourney
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 jagjourney/protonmail-mcp

使用说明

Protonmail MCP服务器

免费、开源 模型上下文协议(MCP)服务器 让像克劳德这样的人工智能助手管理你的Protonmail收件箱。清理电子邮件、标记为已读、标记垃圾邮件、发送消息、离线同步等等——所有这些都是通过自然语言完成的。

由以下人员建造和维护 Jag Journey有限责任公司.


它的作用

此MCP服务器通过以下方式将Claude Desktop(或任何兼容MCP的客户端)连接到您的Protonmail帐户 普罗通海大桥。它使您的AI助手能够:

  • 阅读和浏览 您的收件箱、已发送邮件、草稿和自定义文件夹
  • 搜索 按发件人、主题、日期、正文或已读/标记状态分类的电子邮件
  • 标记为已读/未读 对收件箱进行分类
  • 旗帜/星星 重要电子邮件
  • 转到垃圾邮件 或 垃圾 不需要的消息
  • 移动电子邮件 在任何文件夹或标签之间
  • 发送邮件 使用纯文本或HTML、CC/BCC和回复线程
  • 管理草稿 --保存、更新和组织电子邮件草稿
  • 下载附件 来自任何电子邮件
  • 批量操作 --同时对数百封电子邮件应用操作
  • 提取联系人 从收件箱和已发送文件夹中
  • 电子邮件模板 --从可重用模板中保存、管理和发送
  • 汽车规则 --创建规则以自动对电子邮件进行分类和排序
  • 日历事件 --从电子邮件中提取会议邀请和ICS数据
  • 离线同步 --将整个邮箱导出为可浏览的HTML文件
  • 获取邮箱统计信息 快速浏览您的帐户
  • 管理文件夹 --创建、重命名和删除文件夹
  • 发射 Protonmail桌面应用

先决条件

  1. Protonmail付费计划 (Mail Plus、Proton Unlimited等)
  2. 普罗通海大桥 已安装并在您的PC上运行
  3. Node.js 18+

快速开始

选项A:与npx一起使用(无需安装)

最快的方法——只需将此添加到您的Claude Desktop配置中,然后执行以下操作:

编辑 %APPDATA%\Claude\claude_desktop_config.json (Windows)或 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": ["-y", "protonmail-mcp"],
      "env": {
        "PROTONMAIL_USER": "your-email@proton.me",
        "PROTONMAIL_PASS": "your-bridge-password"
      }
    }
  }
}

重新启动Claude Desktop,您就可以开始了。就这样

选项B:通过npm全局安装

npm install -g protonmail-mcp

然后在Claude Desktop配置中使用:

{
  "mcpServers": {
    "protonmail": {
      "command": "protonmail-mcp",
      "env": {
        "PROTONMAIL_USER": "your-email@proton.me",
        "PROTONMAIL_PASS": "your-bridge-password"
      }
    }
  }
}

选项C:从源代码克隆和构建

git clone https://github.com/jagjourney/protonmail-mcp.git
cd protonmail-mcp
npm install
npm run build

然后在Claude Desktop配置中使用:

{
  "mcpServers": {
    "protonmail": {
      "command": "node",
      "args": ["/path/to/protonmail-mcp/dist/index.js"],
      "env": {
        "PROTONMAIL_USER": "your-email@proton.me",
        "PROTONMAIL_PASS": "your-bridge-password"
      }
    }
  }
}

我在哪里获取网桥密码?

  1. 打开 普罗通海大桥 在您的PC上
  2. 在侧栏中单击您的帐户
  3. 在...之下 邮箱详细信息,找到 密码 领域
  4. 复制它——这是你的 PROTONMAIL_PASS (这与您的常规Protonmail登录不同)

查看完整 安装指南 有关截图的详细步骤。

文档

可用工具(36)

阅读与浏览

工具 说明
list_folders 列出所有包含邮件计数的文件夹
list_emails 浏览任何文件夹中的电子邮件(分页)
read_email 阅读完整的电子邮件内容
search_emails 按发件人、主题、正文、日期、状态搜索
get_email_stats 包含计数的邮箱概述

电子邮件操作

工具 说明
mark_as_read 将电子邮件标记为已读
mark_as_unread 将电子邮件标记为未读
flag_email 星/旗电子邮件
unflag_email 删除星形/旗帜
move_to_spam 报告并转移到垃圾邮件
move_to_trash 移至垃圾箱
move_email 在任何文件夹之间移动
permanently_delete 永久删除(不可逆)

发送和草稿

工具 说明
send_email 发送文本/HTML、CC/BCC格式的电子邮件
save_draft 保存新的电子邮件草稿
update_draft 更新现有草稿

文件夹管理

工具 说明
create_folder 创建新的电子邮件文件夹/标签
rename_folder 重命名现有文件夹
delete_folder 删除空文件夹

附件

工具 说明
list_attachments 列出电子邮件中的所有附件
download_attachment 下载特定附件(base64)

批量操作

工具 说明
bulk_action 将操作应用于与筛选器匹配的所有电子邮件

联系人

工具 说明
extract_contacts 根据最近的电子邮件建立联系人列表

电子邮件模板

工具 说明
save_template 使用{{variables}保存可重复使用的电子邮件模板
list_templates 列出所有已保存的模板
delete_template 删除模板
send_from_template 从模板渲染和发送

自动分类规则

工具 说明
create_rule 创建自动排序规则(按发件人、主题等)
list_rules 列出所有规则
delete_rule 删除规则
run_rules 对文件夹执行所有已启用的规则

日历

工具 说明
extract_calendar_events 从电子邮件中查找和解析会议邀请

离线同步

工具 说明
set_offline_sync_dir 设置脱机电子邮件存档的目录
offline_sync 将电子邮件导出为可浏览的HTML文件
offline_sync_status 检查同步状态和上次同步时间

公用事业

工具 说明
launch_protonmail_app 打开Protonmail桌面应用程序

离线电子邮件同步

将您的整个Protonmail收件箱导出为美观、可浏览的离线存档。离线查看器具有以下功能:

  • 深色主题收件箱UI 这反映了Protonmail的外观和感觉
  • 文件夹导航 未读徽章
  • 完整电子邮件渲染 支持HTML
  • 附件下载 与电子邮件一起保存
  • 增量同步 --仅在重新运行时导出新电子邮件
  • 搜索和筛选 在每个文件夹内
  • 完全离线工作 --只是打开 index.html 在任何浏览器中

如何使用

  1. 告诉克劳德: “将我的脱机邮箱目录设置为C:\Users\Me\Documents\mailbox”
  2. 然后: “脱机同步我的电子邮件”
  3. 打开生成的 index.html 在浏览器中浏览存档

您还可以设置 PROTONMAIL_DATA_DIR 环境变量,用于自定义同步设置的存储位置。

业绩基准

真实世界离线同步测试——将完整邮箱导出为可浏览的HTML,并包含所有附件:

度量 结果
导出的电子邮件 173,352
附件已保存 169,592
已处理文件夹 22
总时间 40分35秒
吞吐量 每秒约71封电子邮件

试验机:

组件 规格
操作系统 Windows 11 Pro
CPU 英特尔酷睿i7-14650HX(16核/24线程)
RAM 64gb DDR5
GPU NVIDIA GeForce RTX 5060笔记本电脑
存储 2TB NVMe SSD(WD Black SN850X)

所有数据都是从本地主机上的Protonmail Bridge的本地缓存中读取的,不需要互联网下载。瓶颈是MIME解析+文件写入,而不是带宽。后续同步是增量的(仅限新电子邮件),在几秒钟内完成。

安全与隐私

  • 所有电子邮件数据都保留在您的本地计算机上
  • 仅连接到 127.0.0.1 (本地主机上的Protonmail桥)
  • Protonmail的端到端加密由Bridge处理
  • 凭据存储在本地 .env 或Claude Desktop配置(从未提交到git)
  • 无遥测、无外部服务、无数据收集

问题与支持

发现错误或有功能请求?在以下网址打开问题: github/jagjourney/protonmail-mcp/issues

许可证

MIT许可证——见 许可证 了解详情。

学分

由...建造 Jag Journey有限责任公司


这是一个社区项目,与Proton AG无关或不受其认可。