protonmail-mcp

あなたのAIコーディングエージェントに、ProtonMailへのアクセスを提供します — 検索、読み取り、下書き作成、送信 — Claude Code、Claude Desktop、Cursor、または任意のMCPクライアントから。

"今日対応が必要なことをProtonで確認して教えて。" "Sarahの最後のメールを見つけて、木曜日の14時でOKと返信の下書きを作って — まだ送らないで。"

Protonはエンドツーエンドで暗号化されているため、公開メールAPIはありません — そこでこれはProton Bridgeと通信します。Protonがまさにこの目的のために提供している公式のローカルゲートウェイです。すべては127.0.0.1上に留まり、復号化されたメールがあなたのマシンから出ることはありません。ここにあるものはホステッドサービスではありません。

始める前に — 唯一の要件

同じマシンで**Proton Bridge**が稼働している必要があります。

• Bridgeには有料のProtonプラン（Mail Plus / Proton Unlimited）が必要です。無料のProtonアカウントはBridgeを使用できないため、これも使用できません。これはProtonの制限であり、当社の制限ではありません。

• BridgeはmacOS、Windows、Linuxで動作します（サーバー上ではprotonmail-bridge --cliでヘッドレス動作）。

• Bridgeは各アカウントに独自の生成済みIMAP/SMTPユーザー名とパスワードを提供します — ここでは通常のProtonログインではなくそれらを使用します。

インストール

# Claude Code — one line, no global install:
claude mcp add protonmail --scope user -- npx -y protonmail-mcp

次に、Bridgeへの接続方法を指定します — 環境変数または設定ファイルのいずれかです。

設定ファイル（~/.config/protonmail-mcp/config.json）:

{
  "user": "you@proton.me",
  "pass": "your-bridge-generated-password",
  "imapPort": 1143,
  "smtpPort": 1025
}

または環境変数: PROTONMAIL_USER、PROTONMAIL_PASS、PROTONMAIL_IMAP_PORT、 PROTONMAIL_SMTP_PORT。（すべてのオプションについてはconfig.example.jsonをコピーしてください。）

エージェントに組み込む前に動作を確認します:

npx protonmail-mcp doctor

これによりBridgeに接続し、認証し、メールボックスを一覧表示します — セットアップの問題は 明確なメッセージとともにここで表示され、会話の途中で不可解に失敗することはありません。

他のMCPクライアント

任意のMCPクライアントで動作します — stdio経由でprotonmail-mcpコマンドを指定します。JSON設定クライアント （Claude Desktop、Cursor、…）の場合:

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": ["-y", "protonmail-mcp"],
      "env": { "PROTONMAIL_USER": "you@proton.me", "PROTONMAIL_PASS": "…" }
    }
  }
}

ツール

読み取り（安全 — エージェントが自由に実行できます）:

書き込み（MCPクライアントは実行前に確認を求める必要があります）:

"readOnly": true（またはPROTONMAIL_READONLY=1）を設定すると、読み取りツールのみを登録します — クライアントの承認設定に関係なく、エージェントが送信・移動・削除を絶対に行えないという強力な保証です。

安全性モデル

重要な書き込みツール — send_message、trash_message、およびsend=trueを指定した reply_to_message — は、MCPクライアントのツールごとの承認が自然なゲートとなるように名前と説明が付けられています。 読み取りはプロンプトを表示しません。送信よりも下書きを推奨します。エージェントが書き、あなたがProtonで確認し、 送信を押します。無人/ヘッドレスセットアップの場合は、readOnlyで実行すれば承認すべき危険なものは単に ありません。

スマートフォンで

これはローカルサーバーなので、エージェントがいる場所ならどこからでもアクセスできます。マシンを **BrainBoxx**とペアリングすれば、ポケットからすべてを操作できます — 「Protonをチェックして、 対応が必要なことを教えて」 電車の中で、帰宅するまでに返信の下書きができています。

動作の仕組み

MCP client (Claude Code / Cursor / …)
        │  MCP over stdio
        ▼
   protonmail-mcp   ──IMAP──►  127.0.0.1:1143  ┐
        │          ──SMTP──►  127.0.0.1:1025  ├─ Proton Bridge ──► Proton Mail
        └── clean JSON in, tool calls out       ┘   (local, TLS, your machine only)

Bridgeはlocalhost上に自己署名証明書を提示します（想定どおり）。これはデフォルトで127.0.0.1に対してそれを信頼します。Bridgeに信頼できる証明書を設定している場合は、"allowSelfSigned": falseを設定して完全な検証を強制します。

ライセンス

MIT © 2026 Simon Stark. Proton AGとは提携しておらず、その承認も受けていません。