Protonmail MCP Server

ProtonMail MCP服务器

ProtonMail Bridge的非官方IMAP支持的MCP（模型上下文协议）服务器。将邮箱操作公开为MCP工具，以便AI助手可以通过本地网桥连接列出、搜索和检索邮件。

新闻

v2026.2.2-重大变更

search_emails 命名至 get_inbox_items -老人 search_emails 该工具（列出了带有可选日期过滤的电子邮件）已重命名为 get_inbox_items 以更好地反映其目的。

新 search_emails 使用关键字搜索 -一个新的 search_emails 该工具现在提供实际的基于关键字的搜索和字段选择：

{
  "mailbox": "INBOX",
  "query": "meeting notes",
  "fields": ["subject", "from"],
  "since_date": "2025-01-01T00:00:00Z",
  "limit": 30
}

快速入门

安装

预构建二进制文件（推荐）：

Linux：

curl -LO https://github.com/TensorTemplar/protonmail-mcp-server/releases/latest/download/protonmail-mcp-server-x86_64-unknown-linux-gnu.tar.gz
tar xzf protonmail-mcp-server-x86_64-unknown-linux-gnu.tar.gz
chmod +x protonmail-mcp-server
sudo mv protonmail-mcp-server /usr/local/bin/

macOS（苹果硅）：

curl -LO https://github.com/TensorTemplar/protonmail-mcp-server/releases/latest/download/protonmail-mcp-server-aarch64-apple-darwin.tar.gz
tar xzf protonmail-mcp-server-aarch64-apple-darwin.tar.gz
chmod +x protonmail-mcp-server
sudo mv protonmail-mcp-server /usr/local/bin/

macOS（英特尔）：

curl -LO https://github.com/TensorTemplar/protonmail-mcp-server/releases/latest/download/protonmail-mcp-server-x86_64-apple-darwin.tar.gz
tar xzf protonmail-mcp-server-x86_64-apple-darwin.tar.gz
chmod +x protonmail-mcp-server
sudo mv protonmail-mcp-server /usr/local/bin/

Windows（PowerShell）：

Invoke-WebRequest -Uri "https://github.com/TensorTemplar/protonmail-mcp-server/releases/latest/download/protonmail-mcp-server.exe-x86_64-pc-windows-msvc.zip" -OutFile "protonmail-mcp-server.zip"
Expand-Archive protonmail-mcp-server.zip -DestinationPath .

通过货物：

# From crates.io
cargo install protonmail-mcp-server --features http

# Or from source
git clone https://github.com/TensorTemplar/protonmail-mcp-server
cd protonmail-mcp-server
cargo install --path . --features http

验证下载（可选）

所有发布的二进制文件都包含用签名的SHA256校验和 Sigstore.

校验和验证：

# Download the checksums file
curl -LO https://github.com/TensorTemplar/protonmail-mcp-server/releases/latest/download/SHA256SUMS.txt

# Verify your downloaded binary (run in same directory as the .tar.gz/.zip)
sha256sum -c SHA256SUMS.txt --ignore-missing
# Expected output: protonmail-mcp-server-x86_64-unknown-linux-gnu.tar.gz: OK

签名验证（需要 联署):

# Download the signature bundle
curl -LO https://github.com/TensorTemplar/protonmail-mcp-server/releases/latest/download/SHA256SUMS.txt.bundle

# Verify the checksums file was signed by this repo's GitHub Actions
cosign verify-blob \
  --certificate-identity-regexp "github.com/TensorTemplar/protonmail-mcp-server" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --bundle SHA256SUMS.txt.bundle \
  SHA256SUMS.txt
# Expected output: Verified OK

配置并运行

# Set environment variables
export IMAP_HOST=127.0.0.1
export IMAP_PORT=1143
export IMAP_USERNAME=your@email.com
export IMAP_PASSWORD=your-bridge-password
export MCP_TRANSPORT=http
export MCP_AUTH_TOKEN=your-secret-token

# Run
protonmail-mcp-server

或者复制并编辑示例env文件：

cp .env.example .env
# Edit .env with your settings
protonmail-mcp-server

HTTP传输部署

建筑

┌─────────────┐     HTTPS/SSE      ┌──────────────────┐     IMAP
│   Agent 1   │◄──────────────────►│                  │◄──────────►┌────────────────┐
├─────────────┤                    │   MCP Server     │            │ ProtonMail     │
│   Agent 2   │◄──────────────────►│   (HTTP+SSE)     │◄──────────►│ Bridge         │
├─────────────┤                    │                  │            │                │
│   Agent N   │◄──────────────────►│ Per-session IMAP │◄──────────►│ localhost:1143 │
└─────────────┘                    └──────────────────┘            └────────────────┘

• 每个MCP会话都有自己的IMAP连接
• 需要承载令牌身份验证
• SSE（服务器发送事件）用于流式响应

配置

注： 如果使用Python MCP SDK\ 旧的SDK无法处理作为保活ping发送的空SSE数据字段。 请参阅： python sdk#1672

正在运行HTTP服务器

# Via environment
MCP_TRANSPORT=http MCP_AUTH_TOKEN=secret123 ./target/release/protonmail-mcp-server

# Via CLI override
./target/release/protonmail-mcp-server --transport http --bind 0.0.0.0:8080

客户端使用情况

# Initialize session
curl -X POST http://localhost:8080/mcp \
  -H "Authorization: Bearer secret123" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'

安全注意事项

1. 网络绑定：默认值 127.0.0.1 （仅限本地主机）。使用 0.0.0.0 用于远程访问。
2. 认证: MCP_AUTH_TOKEN 对于HTTP模式是必需的。
3. 传输层安全：对于生产环境，使用HTTPS在反向代理（nginx、Caddy）后面部署。

可用的MCP工具

赞助商

如果您觉得这个项目有用，请考虑支持我们：

请在SPONSORS.md中列出的付款单中注明您的姓名和项目。