mailbridge

Mailbridge MCP

AI アシスタントをメールに接続できます。iCloud または任意の IMAP アカウントで、メールの閲覧、検索、送信、返信、整理、下書き作成、送信予約、添付ファイルの管理ができます。Claude、OpenAI Codex、Cursor、Windsurf、その他の MCP 対応クライアントで動作します。

認証情報は OS の認証情報ストア（macOS Keychain、Windows Credential Manager、Linux Keyring）に安全に保存され、ファイルには一切保存されません。

---

機能

閲覧と検索

• メールを読む — 受信トレイや任意のフォルダーから、件名、差出人、日付とともにメールを取得します
• 受信トレイの要約 — 優先度スコア、カテゴリ、アクションの提案を含むスマートな要約を作成します
• 検索 — キーワード、差出人、件名でメールを検索します
• スレッド表示 — 任意のメールの会話スレッド全体を表示します
• 連絡先の履歴 — 特定の連絡先との送受信メールをすべて表示します
• 統合受信トレイ — 複数のフォルダーを日付順のビューにまとめます
• 優先度スコア — 各メールの緊急度を自動的に1〜5で評価します
• 自動カテゴリ分類 — メールに「Finance」「Travel」「Calendar」「Newsletter」などのタグを付けます

送信と下書き

• 送信と返信 — 新しいメールを作成するか、スレッドを維持して返信します
• 添付ファイルを送信 — ローカルファイルやインラインコンテンツを送信メールに添付します
• スマート下書き — メールをローカルに保存し、送信前に確認できます
• メールの送信予約 — 将来の時刻にメールを送信するよう予約できます
• 開封確認 — 送信したメールが開かれたときに確認を求める設定ができます（受信者によって異なります。開封確認を参照）

整理

• 一括操作 — 1つのコマンドで複数のメールに既読マークを付けたり、移動したり、削除したりできます
• フォローアップのリマインダー — メールに「3日後にリマインド」のタグを付けると、次回の要約に表示されます
• 配信停止 — List-Unsubscribe ヘッダーを使ってメーリングリストの配信を自動停止します
• メールルール — メールに自動でフラグを付けたり、カテゴリ分類したり、優先度を設定したりするローカルルールを定義できます
• 移動、削除、マーク — 標準的な受信トレイ管理ツールです

添付ファイルとコンテンツ

• 添付ファイルを読む — PDF、DOCX、TXT、JPG、PNG、MP3、MP4 などに対応しています
• 添付ファイルの安全性 — ダウンロード前にすべての添付ファイルをスキャンし、危険なファイル形式をブロックします
• メールをエクスポート — 任意のメールを整形済みの Markdown としてエクスポートします
• カレンダー情報の抽出 — メールや .ics ファイルからイベントの詳細（日付、時刻、場所）を抽出します

アカウント

• 複数アカウント — 複数のアカウントを接続して切り替えられます
• 安全な認証情報 — パスワードは OS のキーチェーンに保存され、平文では保存されません

---

インストール

Claude Cowork

1. Customize → Connectors → Browse Plugins → "+" sign に移動します
2. マーケットプレイスのソースを追加します：https://github.com/Creativestefan/mailbridge-mcp
3. 新しいチャットを開始し、Open Mailbridge setup と入力してセットアップポータルを開き、メールアカウントを接続します
4. iCloud のメールを使う場合は、メールに安全にアクセスするためにアプリ用パスワードを作成する必要があります。通常のパスワードでは認証に失敗します。
5. いつでもセットアップを再度開くには、"open Mailbridge setup" と入力します

後で更新するには： Customize → Connectors → Browse Plugins → (...) ボタンをクリックし、Check for update をクリックします

---

OpenAI Codex

1. Mailbridge マーケットプレイスを追加します：

codex plugin marketplace add Creativestefan/mailbridge-mcp --ref main

2. プラグインをインストールします：

codex plugin add mailbridge@mailbridge

3. 新しい Codex スレッドを開始してテストします：

Use Mailbridge to check my email connection.

4. アカウントがまだ接続されていない場合：

Type "Open Mailbridge setup" and send.

セットアップポータルは、認証情報を OS の認証情報ストア（macOS Keychain、Windows Credential Manager、Linux Keyring）に直接保存します。

後で更新するには：

codex plugin marketplace upgrade
codex plugin add mailbridge@mailbridge

---

Cursor

1. Cursor Settings → Tools & MCP を開きます
2. Add MCP Server をクリックし、次の内容を貼り付けます：

{
  "mcpServers": {
    "mailbridge": {
      "command": "npx",
      "args": ["-y", "mailbridge-mcp@latest"]
    }
  }
}

3. Cursor を完全に終了して再起動します（MCP サーバーは起動時にのみ読み込まれます）
4. 新しいチャットを開始してテストします：

Use Mailbridge to check my email connection.

アカウントがまだ接続されていない場合はセットアップポータルが自動的に開きます。または、"open email setup" と入力します。

後で更新するには： 設定内のバージョンタグを mailbridge-mcp@latest に変更します。常に最新のリリースが取得されます。

---

npm 経由（任意の MCP クライアント）

MCP クライアントの設定（例：claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "mailbridge": {
      "command": "npx",
      "args": ["mailbridge-mcp"]
    }
  }
}

初回起動時にアカウントが設定されていない場合、セットアップポータルが自動的にブラウザーで開きます。メールアドレスなどの情報を入力すると、認証情報が OS の認証情報ストアに直接保存され、ポータルが閉じます。この設定は一度行うだけで済みます。

いつでもセットアップを再度開くには、アシスタントに 「メールのセットアップを開いて」 と頼んでください。

---

セットアップ

初回インストール時に、メールアカウントを接続するためのフォームがブラウザーで自動的に開きます。送信すると、認証情報は OS の認証情報ストアに直接保存されます。ファイルには何も書き込まれません。

いつでもセットアップを再度開くには、アシスタントに 「メールのセットアップを開いて」 と頼むだけです。

iCloud

アプリ用パスワードを使用する必要があります。Apple ID のメインパスワードは使用できません。

account.apple.com → サインインとセキュリティ → アプリ用パスワード → + に移動し、「Mailbridge」という名前を付けて、生成されたパスワードを使用してください。

カスタム IMAP アカウント

完全なメールアドレスとパスワードを使用してください。通常、メールサーバーは mail.yourdomain.com です。不明な場合は、メールプロバイダーの設定を確認してください。

---

ツール

読み取り

ツール	説明
check_connection	接続をテストし、受信トレイの統計を表示します
read_emails	任意のフォルダーからメールを取得します（優先度とカテゴリを含みます）
get_email_body	UID を指定してメールの全文を取得します
get_emails_with_preview	本文の抜粋付きでメールを取得します。受信トレイの要約に使用します
search_emails	キーワード、差出人、または件名で検索します
list_folders	すべてのメールボックスフォルダーを一覧表示します
get_thread	メールの会話スレッド全体を取得します
get_contact_history	特定の連絡先との送受信メールをすべて表示します
unified_inbox	複数のフォルダーを統合し、並べ替えて表示します
export_email	メールを整形済みの Markdown としてエクスポートします
extract_calendar_events	イベントの詳細を抽出し、.ics 添付ファイルを解析します

添付ファイル

ツール	説明
get_attachments	安全性をスキャンして添付ファイルを一覧表示します。ダウンロードは行いません
read_attachment	ユーザーの承認後に添付ファイルをダウンロードして読み取ります

送信と下書き

ツール	説明
send_email	新しいメールを作成して送信します（ファイル添付は任意）
reply_to_email	既存のメールに返信します（ファイル添付は任意）
save_draft	メールをローカルの下書きとして保存します
list_drafts	保存済みの下書きを一覧表示します
send_draft	ID を指定して保存済みの下書きを送信します
delete_draft	保存済みの下書きを破棄します
schedule_email	メールの配信を予約します
list_scheduled	配信待ちの予約済みメールを一覧表示します
cancel_scheduled	メールの配信予約をキャンセルします
check_email_opens	受信トレイをスキャンして開封確認を探し、開封状況を報告します
list_tracked_emails	追跡中のメールと開封状況を表示します（受信トレイのスキャンは行いません）

整理

ツール	説明
mark_as_read	メールを既読にします
mark_as_unread	メールを未読にします
move_email	メールを別のフォルダーに移動します
delete_email	メールをゴミ箱に移動します
bulk_mark_read	複数のメールを既読にします
bulk_mark_unread	複数のメールを未読にします
bulk_move	複数のメールをフォルダーに移動します
bulk_delete	複数のメールをゴミ箱に移動します
set_reminder	メールにフォローアップのリマインダーを設定します
list_reminders	有効なリマインダーを確認します（期限超過のものには印が付きます）
complete_reminder	リマインダーを完了としてマークします
unsubscribe_email	List-Unsubscribe ヘッダーを使用して自動で配信登録を解除します

ルール

ツール	説明
add_rule	メールにフラグを付けたり、分類したり、優先順位を設定したりするローカルルールを追加します
list_rules	設定済みのルールをすべて一覧表示します
remove_rule	名前を指定してルールを削除します
apply_rules	メールのセットに対してルールをドライランで実行します

アカウント

ツール	説明
list_accounts	接続済みのアカウントをすべて表示します
switch_account	アクティブなアカウントを切り替えます
add_account	チャットから新しいアカウントを追加します
remove_account	アカウントを削除します（既定ではアクティブなアカウント）
remove_all_accounts	すべてのアカウントの接続を解除して削除します
open_setup	アカウントの接続や追加を行うセットアップポータルを開きます

---

受信トレイの要約

アシスタントに 「状況を教えて」 または 「見逃したものはある？」 と尋ねると、要点をまとめたダイジェストが表示されます。

各メールには自動的に 優先度スコア（1～5）と カテゴリタグ が付くようになり、ダイジェストがすぐに分類されます。

• 🔴 要対応 — 優先度4～5、または「至急」「期限」「返信が必要」などのキーワード
• 💰 財務・請求 — 請求書、支払い、サブスクリプションの更新
• 📅 イベント・カレンダー — 会議への招待、旅行の確認、出欠の返信
• 📦 更新・参考情報 — ニュースレター、通知、優先度の低いメール

本日が期限、または期限を過ぎた フォローアップのリマインダー は、すべてのダイジェストの先頭に表示されます。

ダイジェストの最後には おすすめのアクション が表示されます。「X の購読を解除する」「Y のリマインダーを設定する」「8 件のニュースレターをまとめてアーカイブする」など、具体的な次のステップが示されます。

---

下書きと送信予約

メールを送信する前に下書きとして保存できます。

「このメールへの返信を下書きして。まず自分で確認する」

メールを後で送信するように予約できます。

「これを [email protected] に明日の午前9時に送って」

予約したメールは、予約時刻以降に次のセッションが開始されたときに自動送信されます。

---

開封確認

Mailbridge に、送信したメールが開封されたタイミングを追跡するよう依頼できます。

「これを [email protected] に送って、開封したら知らせて」

これにより request_receipt: true が設定され、標準の 開封確認ヘッダー（RFC 8098 / MDN） がメッセージに追加されます。その後、

「John は私のメールを開封した？」

と尋ねると check_email_opens が実行され、受信トレイをスキャンして受信者からの確認を探し、誰がいつ開封したかを報告します。

実際の仕組みと制限：

• Mailbridge は トラッキングピクセルではなく、開封確認ヘッダーを使用します。サーバーに情報を送信することはありません。受信者のメールアプリが受信者に確認を求め、確認は通常のメールとして返され、Mailbridge がローカルで読み取ります。
• 確認が届くのは、受信者のクライアントが開封確認に 対応しており、かつ受信者が送信に 同意した 場合のみです。Apple Mail と Thunderbird では確認が求められますが、Gmail のウェブアプリでは無視されます。
• 確認が届かなくても、メールが未読という意味ではありません。 「確認待ち」のステータスは、確認が返ってきていないことを示すだけで、何かを証明するものではありません。
• これはプライバシーを尊重する方法として意図的に採用されています。不可視のピクセルも、サードパーティーのトラッカーもなく、データがデバイスから外部に送信されることもありません。

---

メールのルール

受信トレイの要約時に自動適用されるローカルルールを定義できます。

「[email protected] からのメールにすべて至急フラグを付けて」 「[email protected] からのメールをすべて財務に分類して」 「件名に『invoice due』が含まれるメールの優先度を5に設定して」

ルールはローカルに保存されるため、サーバー側のフィルタリングなしで機能します。

---

添付ファイル

Mailbridge はダウンロード前にすべての添付ファイルをスキャンします。

安全性	意味
✅ 安全	既知の安全なファイル形式で、拡張子と MIME タイプが一致しています
⚠️ 警告	認識できない拡張子、または MIME タイプとの不一致があります。自動ダウンロードされません
🚫 ブロック	実行ファイルまたはスクリプトファイルです。ダウンロードは拒否されます（.exe、.bat、.ps1、.sh、.jar など）

対応ファイル形式：

種類	処理内容
PDF	テキストを抽出して表示します
DOCX	テキストを抽出して表示します
TXT, CSV, MD	プレーンテキストとして表示します
JPG, PNG, GIF, WebP	インラインで表示します。AI は画像を見て説明できます
MP3, MP4, WAV, M4A	一時パスに保存します。文字起こしプラグインに渡してください

---

対応プロバイダー

プロバイダー	IMAP	SMTP
iCloud	imap.mail.me.com:993	smtp.mail.me.com:587
カスタム IMAP	メールサーバー	メールサーバー

---

セキュリティ

• パスワードは OS の認証情報ストアにのみ保存され、ファイルに書き込まれることはありません。
• セットアップポータルは一度限りのブラウザーフォームです。起動して認証情報を収集し、OS のキーチェーンに保存した後、自動的に終了します。
• すべての IMAP および SMTP 接続で SSL/TLS を使用します。
• 添付ファイルはダウンロード前にスキャンされ、実行ファイルとスクリプトは常にブロックされます。
• Mailbridge サーバーにデータが送信されることはありません。すべての処理はお使いのデバイス上でローカルに実行されます。

---

ライセンス

MIT — LICENSE をご覧ください。

---

法的情報

• プライバシーポリシー
• 利用規約