Proton Mail (Bridge)

proton-mail-mcp

AI アシスタントが Proton Mail を読んだり、下書きを作成したり、メールボックスを整理したりできる MCP サーバーです。メールを移動、削除、送信する前に、承認用のプレビューが表示されます。お使いのコンピューター上で Proton Mail Bridge と同じログイン環境で動作し、127.0.0.1 でのみ接続を待ち受けます。

proton-mail-mcp は非公式のものであり、Proton AG とは提携しておらず、同社の承認も受けていません。

uvx mcp-proton-mail setup

ご自身のターミナルで実行してください。インストールでは、事前に必要なものや、確認される内容、MCP クライアントへのサーバーの追加方法について説明しています。

機能

• 検索と閲覧。 メールを検索して件数を数えたり、スレッド全体を読んだり、添付ファイルを読んだり保存したりできます。メールが既読になることはありません。
• 下書きの作成。 新規メール、返信、転送の下書きを作成できます。送信するまで下書きは送信されません。
• 整理。 プレビューを承認してから、移動、アーカイブ、ゴミ箱への移動、既読・未読の切り替え、ラベルの追加・削除、配信停止、下書きの削除、フォルダーの作成を行えます。有効にすると、フォルダールール（ベータ版）も利用できます。
• 有効にした場合の送信。 送信はデフォルトで無効になっており、保存済みの下書きと承認なしで送信する方法はありません。
• チャットでメールを表示。 MCP Apps に対応するクライアントでは、スレッド表示、メール作成画面、送信確認画面を利用できます。それ以外のクライアントでも、同じ内容をテキストで確認できます。

検索を高速に保つため、メールヘッダーの非公開ローカルインデックスも保持します。インデックスにはメール本文は保存されません。

メールを安全に保つ仕組み

読むだけなら何も変わりません。 検索と読み取りではメールボックスを読み取り専用で開き、メールを既読にすることもありません。

メールを変更するには、2つの手順が必要です。

1. プレビュー。 アシスタントは変更内容を確認しますが、この時点では何も変わりません。件数、サンプル、対象を表示し、トークンを取得します。このトークンは1回限りで有効期間が短く、対象のメッセージだけに紐づきます。実行前にサーバーが対象を再確認し、少しでも異なれば拒否します。新しいメールが承認対象に紛れ込むことはありません。
2. 確認。 MCP クライアントは変更内容を正確に記したフォームを表示し、あなたが承認または拒否します。トークンだけでは不十分で、拒否するとトークンは無効になります。フォームの信頼性はクライアント次第です。フォームに自動回答するクライアントでは、この確認を回避できてしまいます。

アクション	必要なもの	元に戻せますか？
検索、件数の確認、読み取り、一覧表示	なし	元に戻すものはありません
下書きまたは添付ファイルの保存	なし。送信はせず、常にログに記録されます	保存した項目は削除するまで残ります
移動、ゴミ箱への移動、アーカイブ、既読または未読への変更、ラベル、フォルダールール（有効時）	プレビュー、トークン、フォーム	undo_action で元に戻せます
登録解除	プレビュー、トークン、フォーム	いいえ。送信が有効な場合、mailto の宛先では未送信の下書きだけが作成され、送信には別途承認が必要です。送信が無効な場合、mailto の宛先は使用されません
下書きの削除	プレビュー、トークン、フォーム	いいえ。取り消せません
フォルダーの作成、ルールの保存（有効時）	プレビュー、トークン、フォーム	いいえ。手動で削除してください
ローカル検索インデックスの再構築	プレビュー、トークン。メールを変更しないためフォームは不要です	いいえ
下書きの送信	デフォルトでは無効。有効にするとプレビュー、トークン、フォームまたは入力した OK が必要です	いいえ
Sieve フィルターの作成（ルールが有効な場合）	プレビューのみ。Bridge には適用する方法がないため、常に拒否されます	何も変わりません
ログに記録された変更を元に戻す	undo_action：トークンやフォームは不要。変更ごとに1回のみで、常にログに記録されます	該当しません

完全削除の対象になるのは、Drafts 内の承認済みメッセージだけです。ラベルを削除すると、そのラベルが付いたコピーだけが完全削除されます。Trash を空にしたり、メールボックスを削除または名前変更したりするツールはありません。書き込みを伴うすべての呼び出しは追記専用の監査ログに記録されます。このログには、メッセージ本文、件名、完全なアドレス、トークンは保存されません。

送信

PROTON_MCP_ENABLE_SEND=1 を設定すると、送信ツールが追加されます。さらに PROTON_MCP_SEND_FROM（送信元アドレス）と PROTON_BRIDGE_CERT（Bridge の証明書）も設定してください。これらがないとプレビューは拒否されます。

自由形式での送信はできません。create_draft、preview_send、send_draft の順に進み、プレビュー後に編集すると拒否されます。フォームを表示できるクライアントでは、フォームが表示されます。フォームがないと宣言するクライアントでは、アシスタントが簡潔な概要を示し、チャットで OK と入力すると送信します。サーバーは、人間が OK を入力したことを証明できません。 それを報告するのはアシスタントだけなので、誤った情報を受け取ったアシスタントが、確認を求めずに送信する可能性があります。PROTON_MCP_SEND_TYPED_OK=0 を設定すると、この方法は無効になります。 詳細は承認の仕組みをご覧ください。

メールボックスの変更に、入力した OK は必要ありません。フォームがないクライアントからの変更は拒否されます。ただし、PROTON_MCP_CONFIRM_MUTATIONS=0 を意図的に設定すると、トークンだけで変更を承認できるようになります。

保護対象の送信者

PROTON_MCP_PROTECTED_CONFIG には、整理、登録解除、下書きの削除、ルールによる処理の対象から除外する送信者のローカルリストを指定できます。このプロジェクトにはリストが同梱されていないため、デフォルトでは銀行や友人からのメールも、ほかのメールと同じように承認できます。 このリストで確認するのは処理対象のメールの送信者であり、下書きの宛先ではありません。保護対象の送信者をご覧ください。

デフォルトでは無効

機能	設定
送信	PROTON_MCP_ENABLE_SEND=1、および PROTON_MCP_SEND_FROM と PROTON_BRIDGE_CERT
自分のアドレス用のフォームを省略	PROTON_MCP_SEND_SELF_NO_FORM=1
指定したクライアントに対する入力式の OK	PROTON_MCP_SEND_TYPED_OK_CLIENTS
保護する送信者	PROTON_MCP_PROTECTED_CONFIG
新着メールの監視	PROTON_MCP_IMAP_IDLE_ENABLED=1
バックグラウンドでのインデックス同期	PROTON_MCP_BACKGROUND_SYNC_ENABLED=1
フォルダルールと Sieve フィルター（ベータ版）	PROTON_MCP_ENABLE_RULES=1
ルールタイマー	自分でインストールする Linux タイマー。ツールから起動することはできません

デフォルトで有効：確認フォーム、送信を有効にした後の入力式の OK、MCP Apps のビュー、起動時のインデックス復旧です。設定に各項目の設定があります。

インストール

必要なもの：

• Bridge の利用に必要な、有料の Proton プラン。
• Linux（Debian/Ubuntu、Fedora/RHEL、または Arch）または macOS。Bridge がすでにインストールされている場合を除き、Homebrew が必要です。Windows のネイティブサポートは新しく、Windows Server のランナーでのみ動作確認されています。まずdocs/windows.mdを読むか、WSL2 を使用してください。
• uv。Python 3.12 以降がインストールされていない場合は、uv が用意します。

PyPI のパッケージは mcp-proton-mail です。uvx が取得して実行するため、クローンする必要はありません。コマンドは proton-mail-mcp で、mcp-proton-mail としてもインストールされます。

1. Proton Mail Bridge アプリが起動している場合は終了し、ログイン時に起動する設定をオフにしてください。セットアップでは Bridge をバックグラウンドサービスとして実行します。アプリと同時には実行できませんが、アプリでのログイン状態は引き継がれます。代わりにアプリを使い続ける場合は、以下に --skip-bridge-service を追加してください。

2. ご自身のターミナルでガイド付きセットアップを実行し、MCP クライアントの名前を指定してください：

uvx mcp-proton-mail setup --client claude-desktop
# or claude-code, chatgpt, codex, gemini, cursor, grok-bot; repeatable

セットアップでは、実行内容が表示され、質問に答えると、変更を加える前に実行計画全体が表示されます。承認するまでは、ほかの変更は行われません（--dry-run を指定すると、計画の表示後に終了します）。例外は、Bridge がインストール済みでもセットアップがアカウントをまだ認識していない場合です。このときは、最初に [Y/n] で Bridge の CLI を開くかどうかを確認し、Bridge にログインできるようにします。Bridge の確認またはインストール、Bridge のパスワードと新しいベアラートークンのシステム認証情報ストアへの保存、ユーザー単位のサービスの起動、サーバーが受信トレイを読み取れることの確認、サーバーのクライアントへの追加を行い、クライアントの設定のバックアップも保存します。ほとんどのクライアントは proton-mail-mcp connect を起動し、トークンを自動的に読み取るため、設定にトークンは含まれません。トークンが表示されることはありません。セットアップは安全に再実行できます。Debian または Ubuntu で python3-venv が見つからずに停止した場合は、sudo apt-get install python3-venv を実行するか、uvx の後に --managed-python を追加してください。

以下の操作はすべてご自身で行います。必要なタイミングはセットアップで案内されます：

• Bridge にログインする：まだログインしていない場合、セットアップが Bridge の CLI を開きます。そこで login と入力し、Proton のメールアドレスとパスワード、2 要素認証コードを入力して、表示された確認用リンクをブラウザーで開きます。貼り付けもできます。その後、セットアップが Bridge から IMAP のユーザー名を読み取ります。
• Bridge のパスワードを入力する：非表示の入力欄で、Proton のパスワードではなく、Bridge が生成したパスワードを入力します。Proton Mail Bridge アプリでメールボックスを選択し、「Mailbox details」を開いて、「Password」の下に表示されるパスワードをコピーしてください。Bridge の CLI では info を実行すると確認できます。そのため、セットアップはご自身のターミナルで実行します。従来の PowerShell または cmd では、非表示の入力欄に貼り付けても動作しないことがあります。Windows Terminal を使い、Ctrl+Shift+V で貼り付けるか、パスワードを入力してください。後でツールに Mailbox authentication failed と表示された場合は、そのエラーにそこで実行するセットアップコマンドが示されます。
• macOS では、確認されたら Keychain へのアクセスを許可する：「Always Allow」を選択してください。
• 最後にクライアントを再起動する：セットアップの案内に従ってください。

3. 動作を確認します。 アシスタントに、利用できる Proton Mail のツールを尋ねてください。search_mail などのツールが表示されるはずです。

後から別のクライアントを追加するには、uvx mcp-proton-mail configure-client --client <name> を実行してください。MCP クライアントの接続には、各クライアントの説明とその他のクライアントに関する情報があります。このセットアップを代行する AI エージェントは、llms-install.mdに従います。ほかの作業はすべて実行し、Bridge へのログインだけをご自身のターミナルで実行するコマンドとして案内します。

ドキュメント

• 初めての方へ： 利用開始ガイドでは、最初のセッションの流れを説明します。
• セットアップ： インストール、MCP クライアントの接続、 設定、Windowsをご覧ください。
• 情報を探す： ツールリファレンスと 結果、拒否、制限をご覧ください。
• 仕組みを知る： 承認の仕組みと、すべてのページをまとめた ドキュメントマップをご覧ください。
• 変更内容： 変更履歴。

PyPI では相対リンクが機能しません。リンク先の内容は リポジトリでご確認ください。

AI アシスタントとコーディングエージェント向け

• このサーバーに接続するアシスタントは、このリポジトリから何も取得する必要はありません。接続時にサーバーから指示とツールの説明が提供されます。
• このプロジェクトについて調べるアシスタントは、これらのドキュメントをまとめたインデックスである llms.txtから読み始められます。
• 誰かの代わりにインストールするアシスタントは、本人にしか実行できない唯一の手順を案内する llms-install.mdに従います。
• このリポジトリを変更するコーディングエージェントは、AGENTS.mdを読む必要があります。

プライバシーポリシー

proton-mail-mcp はお使いのコンピューター上でのみ動作し、テレメトリーはなく、作者に情報を送信することもありません。 PRIVACY.mdでは、読み取る情報、保存場所、削除方法、送信に承認が不要な場合、および MCP クライアントのモデルプロバイダーに送られる情報について説明しています。

ネットワーク接続

PRIVACY.mdには、proton-mail-mcp が行うすべての接続が記載されています。クライアントがプラグインまたはバンドルを起動するたびの実行中の接続に加え、インストールおよびセットアップ中の接続も対象です。

ライセンス

Apache-2.0。