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自身のルールに照らして検証され、不正な入力は黙って修正されるのではなく、呼び出し全体が失敗します。
典型的なワークフロー
- Thunderbirdにアドオンをインストールします。
- ブリッジを起動します(
node mcp-bridge.cjs)か、デスクトップクライアントに起動させます。 - AIモデル(例:Claude)がMCP経由で接続し、認証トークンとポートを受け取ります。
- モデルは
searchMessagesなどのツールを呼び出して関連メールを検索し、getMessageで読み取り、sendMail(skipReviewを無効にした後)で返信を作成します。 - すべてのアクションはThunderbird内で実行され、既存のアカウント、署名、フォルダー構造が保持されます。
対象ユーザー – メールボックスへの深いアクセスを必要とするAIアシスタントを開発する開発者、LLMにメールのトリアージを支援させたいパワーユーザー、プライバシーを重視したローカルホストのスタックで「AIをパーソナルアシスタントとして」試してみたい人。
結論 – Thunderbird MCPは、AIモデルにThunderbirdのメール、連絡先、フィルター、カレンダーに対する具体的で文書化された制御を提供しながら、すべてをデバイス上に保ち、適切な安全デフォルトで保護された、本格的でオープンソースのブリッジです。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト