使用说明
Protonmail MCP服务器
免费、开源 模型上下文协议(MCP)服务器 让像克劳德这样的人工智能助手管理你的Protonmail收件箱。清理电子邮件、标记为已读、标记垃圾邮件、发送消息、离线同步等等——所有这些都是通过自然语言完成的。
由以下人员建造和维护 Jag Journey有限责任公司.
它的作用
此MCP服务器通过以下方式将Claude Desktop(或任何兼容MCP的客户端)连接到您的Protonmail帐户 普罗通海大桥。它使您的AI助手能够:
- 阅读和浏览 您的收件箱、已发送邮件、草稿和自定义文件夹
- 搜索 按发件人、主题、日期、正文或已读/标记状态分类的电子邮件
- 标记为已读/未读 对收件箱进行分类
- 旗帜/星星 重要电子邮件
- 转到垃圾邮件 或 垃圾 不需要的消息
- 移动电子邮件 在任何文件夹或标签之间
- 发送邮件 使用纯文本或HTML、CC/BCC和回复线程
- 管理草稿 --保存、更新和组织电子邮件草稿
- 下载附件 来自任何电子邮件
- 批量操作 --同时对数百封电子邮件应用操作
- 提取联系人 从收件箱和已发送文件夹中
- 电子邮件模板 --从可重用模板中保存、管理和发送
- 汽车规则 --创建规则以自动对电子邮件进行分类和排序
- 日历事件 --从电子邮件中提取会议邀请和ICS数据
- 离线同步 --将整个邮箱导出为可浏览的HTML文件
- 获取邮箱统计信息 快速浏览您的帐户
- 管理文件夹 --创建、重命名和删除文件夹
- 发射 Protonmail桌面应用
先决条件
- Protonmail付费计划 (Mail Plus、Proton Unlimited等)
- 普罗通海大桥 已安装并在您的PC上运行
- 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"
}
}
}
}
我在哪里获取网桥密码?
- 打开 普罗通海大桥 在您的PC上
- 在侧栏中单击您的帐户
- 在...之下 邮箱详细信息,找到 密码 领域
- 复制它——这是你的
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在任何浏览器中
如何使用
- 告诉克劳德: “将我的脱机邮箱目录设置为C:\Users\Me\Documents\mailbox”
- 然后: “脱机同步我的电子邮件”
- 打开生成的
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无关或不受其认可。
