Proton Mail Bridge MCP および CLI

Claude DesktopのためのProton Mailを、正しく実装しました。

🌉 Proton Mail Bridge MCPは、Claude Desktopおよびターミナル向けのローカルファーストなProton Mail統合ツールです。Proton Bridgeを通じてProton Mailの読み取り、検索、下書き作成、送信、同期、管理を行うことができ、完全なMCPサーバーと実用的なCLIの両方を提供します。

セットアップ後、Claude Desktopはコンピュータ上の安定したローカルインストール環境を使用します。単一のリポジトリ、ワークスペース、またはチャットフォルダに限定されません。

考え方はシンプルです：

1. コンピュータに Proton Mail Bridge MCP をインストールする

2. Claude Desktopに接続する

使用するためにMCPの内部構造を理解する必要はありません。Proton Bridgeがすでにマシン上で動作していれば、セットアップは簡単です。

60秒セットアップ

Proton Bridgeがすでにマシン上で動作している場合：

git clone https://github.com/googlarz/proton-mail-bridge-mcp.git
cd proton-mail-bridge-mcp
npm install
npm run setup:claude-desktop

次に：

1. Proton Bridgeを開いたままにする

2. Claude Desktopを再起動する

3. チャットを開き、+ -> Connectors -> proton-mail-bridge を確認する

ターミナル側で高速なヘルスチェックも行いたい場合：

npm run check:claude-desktop
proton-mail-bridge doctor --json

このREADMEに記載されている npm run ... コマンドを使用してください。

セットアップおよびインストーラーのエントリポイントはビルド済みの dist/ 出力内にあり、npmスクリプトが適切なファイルを指しているため、これらが重要となります。

利用される理由

• ツールを切り替えることなく、Claude DesktopからProton Mailを確認できる。

• 請求書、旅行メール、ドキュメント、スレッドをより高速に検索できる。

• Proton Bridgeを通じて下書き、返信、転送、送信ができる。

• Claude Desktopまたはターミナルから直接、同じバックエンドを使用できる。

• Claude DesktopとProton Bridgeのセットアップ問題を迅速に診断できる。

このプロジェクトの存在意義

ClaudeにはネイティブのGmailコネクタがありますが、現時点ではネイティブのProton Mailコネクタはありません。このプロジェクトは、Protonユーザーのためにそのギャップを埋めるものです。

オリジナルの protonmail-pro-mcp というアイデアは非常に有望でしたが、私が着手した時点のコードベースはそのままでは使用できませんでした。私はそれを動作するMCPサーバーとして再構築し、不足していた機能を実装し、日常的に役立つように多くの改善を加えました。

得意なこと：

• Proton Bridgeを通じた真のProtonサポート。

• 読み取りおよび書き込み操作：下書き、送信、返信、転送、アーカイブ、ゴミ箱への移動、復元。

• 添付ファイルの内容へのアクセスとファイルの保存。

• ローカルインデックス作成、スレッドのトリアージ、フォローアップビュー、バックグラウンド更新。

• インストール後、マシン全体で利用可能になるローカルファーストなClaude Desktopセットアップ。

• 同期、検索、読み取り、診断、Claude Desktopのメンテナンス、およびターミナルからの完全なMCPツール実行のための本格的なCLI。

期待できること：

• Proton Bridgeと並行してマシン上でローカルに動作します。

• Claude Desktopにプラグインしますが、ファーストパーティのClaudeコネクタではありません。

• ソースリンクはProtonのウェブメールリンクではなく、MCPレイヤーから提供されます。

• 一度インストールすれば、Claude Desktopはそのコンピュータ上のすべてのチャットで使用できます。

信頼と安全性

• マシン上でローカルに動作します。

• マシン上のProton Bridgeを通じてProton Mailと通信します。

• ホストされたメールリレーやリモートURLサービスを必要としません。

• より安全なデフォルト設定が必要な場合は、読み取り専用モードで実行できます。

• 設定ファイルに生の認証情報を含めたくない場合は、*_FILE および *_COMMAND シークレットをサポートしています。

• 送信やメールボックスの変更は、明示的にその機能を使用した場合にのみ実行されます。

検証済みの機能

以下のパスは、実際のProton Bridgeセットアップに対してライブテスト済みです：

• IMAP接続およびフォルダ一覧表示

• SMTP接続および送信

• メッセージの完全な読み取り

• ローカルインデックス作成および増分同期

• スレッドビュー、ダイジェスト、フォローアップワークフロー

• Proton下書きへのリモート同期

• 添付ファイルの一覧表示および保存

• CLIコマンドおよび汎用MCPツール呼び出し

機能概要

• Proton BridgeのIMAPおよびSMTPを通じてClaudeをProton Mailに接続します。

• フォルダ、メッセージ、添付ファイルを読み取ります。

• ライブメールおよびローカルインデックス化されたメールを検索します。

• 下書きを作成、更新、同期、送信します。

• メールを送信、返信、転送します。

• 既読/未読、スターの付与/解除、移動、アーカイブ、ゴミ箱への移動、復元、削除を行います。

• 増分同期チェックポイントを備えたローカルSQLiteインデックスを構築します。

• IMAP IDLE対応の更新により、メールボックスの変更を監視します。

• IMAPデータから正規化されたラベルとスレッドを再構築します。

• インライン画像、カレンダーの招待状、アーカイブ、署名ファイルなど、より多くの添付ファイルタイプを分類します。

• アクション可能なスレッドビュー、受信トレイダイジェスト、フォローアップ候補、会議準備、ドキュメント検索ビュー、スレッド概要を生成します。

• バッチおよびスレッドのメールボックス操作に対して、より安全なドライランプレビューをサポートします。

• 下流の引用スタイルレンダリングのために、MCPリソースリンクと構造化されたソースメタデータを生成します。

知っておくべきこと

• Proton Bridgeを使用します。 理由：このプロジェクトは、Proton Bridgeが提供するローカルのIMAPおよびSMTPアクセスを通じて接続するためです。

• ローカルで実行されます。 理由：Proton Bridgeは通常自分のマシン上で実行されるため、このMCPサーバーもローカルで実行されるように設計されています。

• スレッドとラベルはIMAPデータから再構築されます。 理由：Protonネイティブのスレッドおよびラベルオブジェクトは、ファーストパーティのClaudeコネクタパスでは利用できないためです。

• 添付ファイルの処理は広範囲ですが、魔法ではありません。 理由：カレンダーの招待状や一般的なドキュメント/画像添付ファイルを含む一般的なケースはうまく機能しますが、メールのMIME形式は送信者やクライアントによって依然として乱雑になる可能性があるためです。

まだ不足している機能とその理由

• 標準でリモートURLコネクタはありません。 理由：現在の製品は自分のマシン上のProton Bridgeと通信するものであり、Proton Bridgeは通常ローカルで動作するもので、ホストされたサービスではないためです。

• ファーストパーティのClaude認証フローやネイティブのProtonディープリンクはありません。 理由：それらにはAnthropicからのプラットフォームレベルのサポートと、IMAP/SMTPが提供できる以上のProtonからのリッチなプロバイダーサポートが必要なためです。

• 真のProtonネイティブな会話モデルはありません。 理由：このプロジェクトは、よりリッチなProton固有のAPIを呼び出すのではなく、Bridgeのメールデータからスレッドとラベルを再構築しているためです。

• よりネイティブなProton体験は将来的に可能です。 理由：Protonがより優れたパブリック統合パスや、よりクリーンなローカル/ホスト型ブリッジのストーリーを提供すれば、このプロジェクトはネイティブのGmail体験に近づくことができます。私はそのエコシステムの改善を待っています。

始める前に

必要なもの：

1. Claude Desktop

2. Node.js 18以降

3. Protonアカウント

4. インストールおよびサインイン済みのProton Bridge

5. 約10分

Proton Bridgeから必要なもの：

• IMAPホスト

• IMAPポート

• SMTPホスト

• SMTPポート

• ユーザー名

• Bridgeパスワード

ほとんどのローカルBridgeセットアップにおけるデフォルト値は以下の通りです：

• IMAPホスト: 127.0.0.1

• IMAPポート: 1143

• SMTPホスト: 127.0.0.1

• SMTPポート: 1025

🚀 セットアップの概要

セットアップには2つのパートがあります：

1. ローカルMCPサーバーのインストール

2. Claude Desktopへの接続

通常はガイド付きセットアップウィザードを使用します。手動パスは、より詳細な制御を求めるユーザー向けです。

重要：

• リポジトリフォルダは、MCPのインストールまたは更新にのみ必要です。

• Claude Desktop自体は、セットアップ後に安定したマシン全体のランタイムを使用します。

• したがって、これは特定のプロジェクトフォルダだけでなく、コンピュータ上の一般的なClaude Desktop使用のためのものです。

パート1：コンピュータへのProton Mail Bridge MCPのインストール

1. 🔐 Proton Bridgeを開く

Proton Bridgeを開き、アカウントが接続されていることを確認します。

Bridgeでメールボックスの詳細または「メールクライアントの設定」ビューを開き、以下をコピーします：

• IMAPホストとIMAPポート

• SMTPホストとSMTPポート

• ユーザー名

• Bridgeパスワード

Proton Bridgeを実行したままにしてください。このMCPを使用している間は閉じないでください。

2. 📥 プロジェクトのダウンロード

git clone https://github.com/googlarz/proton-mail-bridge-mcp.git
cd proton-mail-bridge-mcp
npm install

必要に応じて、リポジトリをクローンする代わりに、最新のGitHubリリースからソースをダウンロードすることもできます。

マシンに npm が存在しない場合は、まずNode.js 18+をインストールしてから、コマンドを再実行してください。

この時点で、MCPサーバーファイルはコンピュータ上にあり、Claude Desktopのステップに進む準備ができています。

リポジトリは好きな場所にクローンできます。このフォルダはインストールと更新に使用されます。セットアップ完了後、Claude Desktopはこのフォルダに縛られません。

パート2：Claude Desktopへの使用指示

3. 🪄 Claude Desktop用のProton Mail Bridge MCPを設定する

npm run setup:claude-desktop

このコマンドはClaude Desktopアプリ自体をインストールするものではありません。

Claude Desktopはすでにインストールされているはずです。

このコマンドが行うことは以下の通りです：

• 標準のProton Bridgeローカルポートを確認する

• Proton Bridgeのユーザー名とBridgeパスワードを尋ねる

• 上書きしない限り、標準のローカルBridgeアドレスを使用する

• このMCPサーバーをビルドする

• Claude Desktop用に、このリポジトリ外に安定したローカルランタイムコピーをインストールする

• インストールされたランタイムの起動方法をClaudeに指示するClaude Desktop設定エントリを書き込む

• このMCPサーバーが必要とする PROTONMAIL_* 値をそのローカルClaude Desktop設定内に保存する

• 変更前に古いClaude Desktop設定をバックアップする

つまり、平易な言葉で言えば：

• このコマンドは、このコンピュータ上のClaude Desktop向けProton Mail Bridge MCP統合をインストールまたは更新します。

• Claude Desktopアプリ自体はインストールしません。

• 実行したフォルダにClaudeをロックすることはありません。

4. 🔁 Claude Desktopの再起動

ウィザード終了後：

• Claude Desktopを再起動する

• Proton Bridgeを開いたままにする

• Claude Desktopでチャットを開く

• チャットボックス近くの + ボタンをクリックし、Connectors を開く

• proton-mail-bridge が表示され、ツールが利用可能であることを確認する

• 二重確認が必要な場合は、Claude Desktopの開発者設定を開き、MCP接続ステータス/ログを確認する

安定したランタイムがインストールされる場所：

• macOS: ~/Library/Application Support/Proton Mail Bridge MCP

• Linux: ~/.local/share/proton-mail-bridge-mcp

• Windows: %APPDATA%\Proton Mail Bridge MCP

🤖 Claude Desktopでの動作の仕組み

すでにClaude Desktopを開いている場合、最初に知っておくべきことは以下の1点です：

• Claude DesktopはURLを要求するリモートコネクタもサポートしています。

• このプロジェクトはその種のコネクタではありません。

• Proton Bridgeもマシン上でローカルに動作するため、これもローカルで動作します。

• したがって、ここでの正しいセットアップは、リモートURLボックスではなく、ローカルのClaude Desktopインストールフローです。

これが依然として有用な理由：

• Gmailは現在、最もネイティブなClaude体験を得られます。

• Protonユーザーにはまだ同じファーストパーティのパスがありません。

• このプロジェクトは、Claude Desktopに実用的なローカルProton統合を今すぐ提供します。

貼り付けるリモートURLがない理由：

• リモートURLコネクタは、ホストされたMCPサーバーを想定しています。

• このプロジェクトは、あなたのマシン上のProton Bridgeに到達することを想定しています。

• Proton Bridgeは通常、127.0.0.1 上でローカルのIMAP/SMTPアクセスを公開します。

• したがって、最もシンプルで安全なセットアップはリモートではなくローカルです。

つまり、現在のリリースでサポートされているClaude Desktopパスは以下の通りです：

• ガイド付きのゼロ手動設定フローのための npm run setup:claude-desktop

• 高度な、または自動化されたClaude Desktopインストールのための npm run install:claude-desktop

• このリポジトリを更新した後にインストール済みのClaude Desktopランタイムを更新するための npm run update:claude-desktop

• Claude Desktopが有効なProton Mail Bridge MCPランタイムを指していることを確認するための npm run doctor:claude-desktop

• CLAUDE-DESKTOP-PACKAGING.md に文書化されている .mcpb ローカル拡張トラック

🖥️ CLI

Proton Mail Bridge MCPはターミナルから直接使用することもできます。

これは以下の場合に便利です：

• Claude Desktopを開かずにProton Bridgeをテストする

• より少ないステップでクイック検索や読み取りを行う

• 同期と診断をスクリプト化する

• Claudeに使用させる前にローカルのメールスタックが動作することを確認する

• ターミナルから完全なMCPツールサーフェスを直接呼び出す

CLIバイナリは以下の通りです：

proton-mail-bridge

または、リポジトリから：

npm run cli -- help

主なコマンド：

• proton-mail-bridge status

• proton-mail-bridge doctor

• proton-mail-bridge sync --folder INBOX --limit 150

• proton-mail-bridge search "label:inbox invoice"

• proton-mail-bridge search --live --from openai.com

• proton-mail-bridge read INBOX::25642

• proton-mail-bridge tools

• proton-mail-bridge tool get_connection_status

• proton-mail-bridge tool search_indexed_emails --args '{"query":"invoice","limit":3}'

• proton-mail-bridge claude check

• proton-mail-bridge claude install

ほとんどのコマンドは、機械可読な出力のために --json をサポートしています。

実践的な例：

# Check whether Proton Bridge and Claude-side wiring are healthy
proton-mail-bridge doctor --json

# Search indexed mail
proton-mail-bridge search "label:inbox invoice" --limit 10

# Read one message
proton-mail-bridge read INBOX::25642

# Call any MCP tool directly from Terminal
proton-mail-bridge tools
proton-mail-bridge tool get_connection_status --json
proton-mail-bridge tool search_indexed_emails --args '{"query":"invoice","limit":3}'

# Check Claude Desktop integration
proton-mail-bridge claude check --json

CLIがMCPサーバーが公開するすべてに到達できるようにしたい場合は、以下を使用します：

proton-mail-bridge tools
proton-mail-bridge tool <tool-name> --args '{"key":"value"}'
proton-mail-bridge tool <tool-name> --args-file ./input.json

これにより、同じシステムを使用する2つの方法が得られます：

• Claude DesktopはMCPサーバーとして使用する

• ターミナルは汎用MCPツール呼び出しを含むCLIとして使用する

Bridgeユーザー向けのゼロ手動設定パス

1. プロジェクトフォルダでターミナルを開く。

2. 以下を実行：

npm run setup:claude-desktop

3. 以下のプロンプトに回答する：

   • Proton Bridgeのユーザー名

   • Proton Bridgeのパスワード

   • 標準のローカルBridgeポートを使用するかどうか

   • ローカルデータをどこに保存するか

4. Claude Desktopを再起動する。

5. Claudeを開き、Proton Mail Bridge MCPツールが利用可能であることを確認する。

手動のJSON編集や手動の環境変数設定を回避できるため、これが