protonmail-mcp
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ログインではなくそれらを使用します。
Related MCP server: ProtonMail MCP Server
インストール
# 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": "…" }
}
}
}ツール
読み取り(安全 — エージェントが自由に実行できます):
ツール | 説明 |
| フォルダ/ラベルを一覧表示 |
| メールボックス内の最新メッセージ(概要) |
| 未読メッセージ(概要) |
| テキスト / 差出人 / 宛先 / 件名 / 日付範囲で検索 |
| uidによる完全なメッセージ(引用履歴はデフォルトでトリミング) |
書き込み(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とは提携しておらず、その承認も受けていません。
Available Tools
8 toolscreate_draftA
Compose a new email and save it to Drafts. Does NOT send — you review and send it yourself in Proton. Can include local file attachments.
Inputs: to (required), subject (required), cc, bcc, +3 more.
download_attachmentA
Save an attachment from a message to disk (into the configured download directory). Identify it by filename or 0-based index (from get_message); if the message has just one attachment, neither is needed. Returns the saved file path.
Inputs: uid (required), index, mailbox, filename.
forwardA
Forward a message to new recipients, carrying its original attachments. Optional intro note via body. Sends immediately unless draft=true. Can add further local file attachments.
Inputs: to (required), uid (required), body, html, +3 more.
get_messageA
Read one full message by uid (from a search result). Quoted reply history and signatures are trimmed by default for readability; pass full=true to keep everything. The result lists any attachments (name/type/size) — use download_attachment to save one.
Inputs: uid (required), full, mailbox.
replyA
Reply to a message (to its sender), correctly threaded, quoting the original. Sends immediately unless draft=true (saves to Drafts for you to review). Can include local file attachments.
Inputs: uid (required), body, html, draft, +2 more.
reply_allA
Reply to a message and everyone on it (sender + all other recipients, excluding you), threaded and quoting the original. Sends immediately unless draft=true. Can include local file attachments.
Inputs: uid (required), body, html, draft, +2 more.
search_mailA
Search email by any combination of free-text, sender, recipient, subject, and date range. With NO filters it returns your most recent inbox messages. Returns summaries (no body) newest first — use get_message with a result's uid to read the full text.
Inputs: to, from, limit, query, +5 more.
send_messageA
Send a new email immediately. This goes out the moment it runs — the client should confirm first. To let a human review before sending, use create_draft instead. Can include local file attachments.
Inputs: to (required), subject (required), cc, bcc, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools are clearly distinct: search/get/download form a retrieval pipeline, and create_draft/send_message are explicitly contrasted. reply, reply_all, and forward could be confused, but their descriptions precisely define recipient behavior and threading.
Most tools follow a clear verb_noun pattern like search_mail, get_message, download_attachment, create_draft, send_message. However, reply and forward are bare verbs, and reply_all mixes a verb with an adverb, creating minor inconsistency.
Eight tools is a well-scoped set for an email-focused server. Each tool covers a distinct core email action without unnecessary redundancy or bloat.
The set covers search, read, download attachments, reply, reply-all, forward, draft, and send — the essential email workflows. Minor gaps like delete, move, or archive exist, but agents can handle common tasks end-to-end.
Maintenance
Related MCP Connectors
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email safety MCP server. Detects phishing, prompt injection, CEO fraud for AI agents.
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
Related MCP Servers
- AlicenseAqualityDmaintenanceA read-only MCP server that connects to Proton Mail via Proton Bridge, enabling AI assistants to search, list, and read emails securely without leaving your machine.41MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that connects to ProtonMail via Bridge, enabling AI assistants like Claude to manage your email.3MIT
- FlicenseNot gradedqualityBmaintenanceA lightweight MCP server providing AI agents a scoped, read-and-draft-only view into Proton Mail via Proton Bridge, with code-enforced restrictions preventing external access or sending.-
- FlicenseNot gradedqualityDmaintenanceA security-first MCP server that provides AI agents with a scoped, read-and-draft-only view into Proton Mail via Proton Bridge, ensuring no emails can be sent and access is restricted to configured workspaces.5-