TKasperczyk/thunderbird-mcp

MCP server for Thunderbird - enables AI assistants to access email, contacts, and calendars

Thunderbird MCP – Thunderbird向けAIフレンドリーブリッジ

概要 – ThunderbirdアドオンとNode.jsブリッジを組み合わせたもので、Model-Context-Protocol(MCP)対応のAIアシスタント(Claude、GPT、ローカルLLMなど)が、Thunderbird内からメール、連絡先、フィルター、カレンダーを直接読み取り、作成、整理、検索できるようにします。

重要性 – Thunderbirdには公式APIがありません。このブリッジがないと、AIは受信トレイを確認したり、返信の下書きを支援したりできません。この拡張機能は、MCP経由で約40のツール(アカウント一覧、メッセージ検索、メッセージ本文の完全取得、メール送信、フィルター管理、連絡先、カレンダーイベントなど)を安全に公開し、AIエージェントが人間と同じようにメールボックスを操作できるようにします。

仕組み

  • アドオンには、localhost:8765‑8774で待ち受けるHTTPサーバーが含まれており、セッションごとの認証トークンを使用します。
  • Node.jsスクリプト(mcp-bridge.cjs)が標準のMCP stdioプロトコルをローカルHTTP APIに変換し、接続ファイルを介してポート/トークンを検出し、MCPライフサイクル呼び出し(initialize、ping)を処理するため、Thunderbirdの読み込み完了前でもAIが接続できます。
  • すべての通信はローカルマシン内で完結し、外部ネットワークトラフィックは不要です。

主な機能

領域 ツール(抜粋) できること
メール listAccounts、listFolders、searchMessages、getMessage(s)、displayMessage、updateMessage、deleteMessages、createFolder … アカウントの参照、ヘッダー/本文での検索、Markdown/テキスト/HTMLでのメッセージ読み取り、UIでの表示、既読/未読の設定、タグ追加、移動/コピー、フォルダーの作成/削除、ゴミ箱/迷惑メールの空にする。
作成 sendMail、saveDraft、replyToMessage、forwardMessage 確認ウィンドウを開く、または(skipReviewブロックの安全フラグを無効にした後)直接送信、下書き保存、適切なスレッドで返信、添付ファイル付きで転送。
フィルター listFilters、createFilter、updateFilter、deleteFilter、reorderFilters、applyFilters メールフィルターの一覧表示、作成、編集、並べ替え、手動実行。安全デフォルトにより、明示的に有効にしない限り自動転送/返信アクションはブロックされます。
連絡先 searchContacts、getContact、createContact、updateContact、deleteContact アドレス帳エントリの検索、読み取り、作成、変更、削除。
カレンダー listCalendars、createEvent、listEvents、updateEvent、deleteEvent カレンダーの一覧表示、イベント作成(デフォルトで確認ウィンドウ)、繰り返し展開を含むイベントのクエリ、編集または削除。

安全性とプライバシー

  • ローカルのみ – サーバーはlocalhostにバインドされ、セッションごとのトークンを使用します。データがコンピューターから送信されることはありません。
  • デフォルトで確認 – skipReviewの設定をオフにしない限り、メール送信、参加者を含むイベント作成、自動フィルターアクションはブロックされます。
  • 暗号化メール – オプトインしない限り、暗号化メッセージへのアクセスは無効です。
  • MIMEとサイズ制限 – インライン画像はMCP画像ブロックとしてのみ含まれます(各1 MiB、合計4 MiB)。2 MiBを超えるHTML本文は、明確な通知とともに切り詰められます。
  • 厳格な検証 – タグキー、フィルター文字列、連絡先フィールド、カレンダー参加者はThunderbird自身のルールに照らして検証され、不正な入力は黙って修正されるのではなく、呼び出し全体が失敗します。

典型的なワークフロー

  1. Thunderbirdにアドオンをインストールします。
  2. ブリッジを起動します(node mcp-bridge.cjs)か、デスクトップクライアントに起動させます。
  3. AIモデル(例:Claude)がMCP経由で接続し、認証トークンとポートを受け取ります。
  4. モデルはsearchMessagesなどのツールを呼び出して関連メールを検索し、getMessageで読み取り、sendMail(skipReviewを無効にした後)で返信を作成します。
  5. すべてのアクションはThunderbird内で実行され、既存のアカウント、署名、フォルダー構造が保持されます。

対象ユーザー – メールボックスへの深いアクセスを必要とするAIアシスタントを開発する開発者、LLMにメールのトリアージを支援させたいパワーユーザー、プライバシーを重視したローカルホストのスタックで「AIをパーソナルアシスタントとして」試してみたい人。


結論 – Thunderbird MCPは、AIモデルにThunderbirdのメール、連絡先、フィルター、カレンダーに対する具体的で文書化された制御を提供しながら、すべてをデバイス上に保ち、適切な安全デフォルトで保護された、本格的でオープンソースのブリッジです。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト