AI导哈

邮件管理服务器

ProtonMail MCP Server是一款用于ProtonMail的邮件管理服务器，提供23种工具通过Proton Bridge进行邮件管理。

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

使用说明

ProtonMail MCP 服务器

ProtonMail的模型上下文协议服务器，配备23种工具通过Proton Bridge进行电子邮件管理。

特点/特性

  • 电子邮件发送 - 发送包含HTML/文本、附件、抄送(Cc)/密送(Bcc)、自定义头部的电子邮件
  • 阅读电子邮件 - 通过IMAP获取、搜索和过滤电子邮件
  • 文件夹管理 - 创建、删除、重命名、列出和同步文件夹
  • 电子邮件操作 - 标记为已读/未读，加星标，移动，删除
  • 分析（或“数据分析”） - 邮件量趋势、联系人统计、响应时间分析
  • 系统工具 - 连接状态、缓存管理、日志记录

快速入门

先决条件

  • ProtonMail账户
  • 质子桥 已安装并运行
  • Node.js 18.0.0及以上版本

安装

来自 npm：

npm install -g protonmail-mcp-server

来源：

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

配置

编辑Claude桌面配置（~/Library/Application Support/Claude/claude_desktop_config.json （在 macOS 上）：

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": ["-y", "protonmail-mcp-server"],
      "env": {
        "PROTONMAIL_USERNAME": "your-email@protonmail.com",
        "PROTONMAIL_PASSWORD": "your-bridge-password",
        "PROTONMAIL_SMTP_HOST": "127.0.0.1",
        "PROTONMAIL_SMTP_PORT": "1025",
        "PROTONMAIL_IMAP_HOST": "127.0.0.1",
        "PROTONMAIL_IMAP_PORT": "1143"
      }
    }
  }
}

注释：

  • 使用 127.0.0.1 不 localhost 以避免IPv6问题
  • 密码是您的Proton Bridge密码，而非您的ProtonMail登录密码
  • 从Proton Bridge获取桥接密码 → 设置 → 邮箱密码

可用工具

发送电子邮件

  • send_email - 发送包含HTML/文本、附件、抄送/密送的电子邮件
  • send_test_email - 发送测试邮件

阅读电子邮件

  • get_emails - 分页/过滤获取电子邮件
  • get_email_by_id - 获取特定电子邮件
  • search_emails - 使用多个条件进行搜索

文件夹管理

  • get_folders - 列出带有统计信息的文件夹
  • sync_folders - 同步文件夹结构
  • create_folder - 创建新文件夹
  • delete_folder - 删除文件夹（必须为空）
  • rename_folder - 重命名文件夹

电子邮件操作

  • mark_email_read - 标记为已读/未读
  • star_email - 标记为星标/取消星标
  • move_email - 在文件夹之间切换
  • delete_email - 永久删除

分析（学）

  • get_email_stats - 电子邮件统计
  • get_email_analytics - 分析与见解
  • get_contacts - 联系互动统计
  • get_volume_trends - 随时间变化的电子邮件数量

系统

  • get_connection_status - 检查SMTP/IMAP状态
  • sync_emails - 手动同步
  • clear_cache - 清除缓存
  • get_logs - 获取日志

故障排除

连接被拒绝 ::1:1143

  • 使用 127.0.0.1 而不是 localhost
  • 验证Proton Bridge是否正在运行： lsof -i :1025 -i :1143

认证失败

  • 使用Proton Bridge密码（而非ProtonMail登录密码）
  • 从Proton Bridge进入 → 设置 → 邮箱密码

证书错误

  • 对于本地主机，自动接受自签名证书

发展

npm run dev      # Watch mode
npm run build    # Build
npm run lint     # Type check

许可证

麻省理工学院 - 见 许可证

链接

非官方第三方服务器，与Proton AG无关联。

相关 MCP