MCP for Thunderbird

Thunderbird 向け MCP

Thunderbird 向け MCP を使うと、コンピューター上の AI アプリが、Thunderbird で設定した範囲内で Thunderbird のメールを操作できます。

Claude Desktop、Claude Code、Codex、Cursor などの AI アプリは、オープン標準である Model Context Protocol（MCP）を通じて外部のツールに接続します。Thunderbird 向け MCP は、メールを検索する、メッセージを読む、受信トレイを整理する、確認用の下書きを作成するといったメールツールを提供します。使用できるアカウントと実行できる操作は自分で選択でき、Thunderbird のツールバーからいつでも一時停止できます。

Thunderbird 向け MCP は Thunderbird と連携します。Thunderbird の開発元である Mozilla または MZLA Technologies が開発、推奨、提供するものではなく、これらの組織とは提携していません。

仕組み

Thunderbird 向け MCP は、次の 2 つの部分で構成されています。

• アドオン：Thunderbird にインストールします。Thunderbird の標準的なアドオンインターフェースを通じてメールを操作し、設定、アクティビティログ、一時停止スイッチを保持します。
• ホスト：同じコンピューターにインストールする小さなプログラムです。Thunderbird の起動時に Thunderbird が起動し、Thunderbird を終了すると停止します。AI アプリはホストと通信し、ホストはリクエストをアドオンに渡します。

Thunderbird にはすでにメールボックスへのログイン情報とメールのコピーがあるため、Thunderbird 向け MCP がメールのパスワードを求めることはありません。外部サーバーを経由するものはありません。アドオン、ホスト、AI アプリは、コンピューター上でのみ相互に通信します。その後、AI アプリ自体は、ほかの提供情報と同様に、読み取った内容を提供元に送信します。PRIVACY.md では、データの送信先を詳しく説明しています。

AI アプリでできること

ツールはいくつかのグループに分かれており、アドオンのオプションでグループごとに有効または無効にできます。無効にしたグループのツールは、AI アプリに一切公開されません。

グループ	ツール	機能
読み取り	mail_accounts, mail_folders, mail_search, mail_read, mail_thread, mail_attachment, mail_filter_suggest	アカウントとフォルダーの一覧表示、メールの検索、メッセージの読み取り、会話内のメッセージ一覧の表示、指定したフォルダーへの添付ファイルの保存、作成するメールフィルターの説明。
整理	mail_mark, mail_tag, mail_move, mail_archive, mail_trash	既読またはフラグ付きとしてマーク、タグの追加または削除、別のフォルダーへの移動またはコピー、アーカイブ、ゴミ箱への移動。
下書き	mail_draft, mail_compose	新規メッセージ、返信または転送を下書きに保存、内容が入力済みの作成ウィンドウを開いて確認・送信。
連絡先	mail_contacts	アドレス帳から連絡先を検索。
送信	mail_send	ウィンドウを開かずにメッセージを送信。送信先は指定した受信者のみです。自分で有効にしない限り無効です。

できないこと

• メールを完全に削除すること。 整理ツールでメールをゴミ箱に移動することはできますが、ゴミ箱や迷惑メールフォルダーを空にしたり、フォルダーを削除したり、アカウント設定を変更したりするツールはありません。
• Thunderbird のメッセージフィルターを編集すること。 Thunderbird にはフィルターを変更するアドオン用の手段がないため、mail_filter_suggest は Thunderbird の「メッセージフィルター」ウィンドウで実行する手順を提示します。
• カレンダーとタスクを操作すること。 Thunderbird には、これらに対応する安定したアドオンインターフェースがありません。
• ウェブブラウザー上の AI アプリと連携すること。 ブラウザータブで使う ChatGPT や claude.ai などが該当します。これらはインターネット上のサーバーを通じてツールにアクセスしますが、Thunderbird 向け MCP はコンピューター上でのみ接続を待ち受けます。
• Thunderbird の終了中に動作すること。 ホストは Thunderbird の実行中のみ動作します。その間に AI アプリからリクエストがあると、「Thunderbird is not running」と通知されます。
• Thunderbird for Android で動作すること。

安全性のデフォルト設定

• チェックを入れるまで、アカウントは使えません。 初回起動時にセットアップページが表示され、AI アプリで使用できるアカウントを選択します。最初はどれにもチェックが入っていません。
• 推奨されるレベルは「読み取りと整理」です。 有効にするまでは、下書きの作成と連絡先へのアクセスはオフです。
• 送信はできません。 デフォルト設定では、AI アプリがメールを送信したり、何かを完全に削除したりすることはできません。下書きと作成ウィンドウでは、送信するかどうかを自分で決められます。直接送信は、オプションで有効にし、送信を許可するアドレスまたはドメインを指定して、Thunderbird 独自の権限確認で許可しない限り、オフのままです。
• 検索結果にメッセージ本文が含まれることはありません。 検索結果は、送信者、件名、日付、フォルダー、フラグを示す参照情報です。AI アプリがメッセージ本文を読むには、そのメッセージを個別に指定して要求する必要があります。
• メッセージ本文には信頼できないデータとして印が付けられます。 非表示のテキスト、スクリプト、不可視文字は、実用上可能な限り取り除かれ、残った内容は、送信者からのデータであって指示ではないことをAI アプリに伝えるブロックで囲まれます。
• ローカル限定で、アクセスキーが必要です。 ホストは127.0.0.1のみでリッスンし、アクセスキーを含むリクエストにだけ応答します。セットアップで接続したAI アプリは自らアクセスキーを読み取るため、手動でキーをコピーする必要はありません。
• 状況を確認して停止できます。 ツールバーのボタンで、Thunderbird 用 MCP が接続中、一時停止中、未接続のいずれかを確認できます。メニューの「一時停止」ボタンを押すと、再開するまでリクエストをすべて拒否します。オプションのアクティビティログには、直近500件のリクエスト（時刻、アプリ、ツール、結果）が表示されます。メッセージ本文やアドレスは記録されません。

SECURITY.md では、脅威と保護策について、その限界を含めて詳しく説明しています。

対応バージョン

• Windows、macOS、Linux で動作する Thunderbird 153 以降。以前のバージョンには、MCP for Thunderbird がウィンドウを開かずに下書きを保存するために必要なアドオンインターフェースがありません。
• Linux 上の Thunderbird ESR 153.4 でテスト済みです。Windows の Thunderbird 158 と macOS の Thunderbird 157 は、CI で実行されるエンドツーエンドテストの対象です。
• アカウントの種類：IMAP でテスト済みです。MCP for Thunderbird は Thunderbird の汎用メールインターフェースのみを使用するため、Gmail や IMAP 経由の Microsoft 365 など、Thunderbird が対応する他のアカウントの種類も同様に動作するはずです。Thunderbird 組み込みの Exchange サポートで追加した Exchange アカウントはテストされていません。
• Linux：thunderbird.net からダウンロードした Thunderbird と、Snap または Flatpak ではないディストリビューションのパッケージが動作します。Snap（現在の Ubuntu で apt install thunderbird を実行するとインストールされるもの）はテストされておらず、Flatpak はサポートされていません。詳しくはINSTALL.mdをご覧ください。

クイックスタート

1. GitHub のリリースページから、お使いのシステム用のホストをインストールします。Windows と macOS では、発行元が不明であるという警告が表示されます。続行する方法はINSTALL.mdをご覧ください。Linux では、その後、自分のユーザーとして mcp-for-thunderbird setup を実行します。
2. 同じリリースページから、Thunderbird にアドオンをインストールします。mcp-for-thunderbird-<version>.xpi をダウンロードし、≡メニューを開いて、アドオンとテーマ、歯車ボタン、**ファイルからアドオンをインストール…**の順に選び、ファイルを指定します。（アドオンを自動更新するaddons.thunderbird.netでの公開は、今後予定されています。）
3. アドオンのセットアップページが開きます。AI アプリで使用できるアカウントにチェックを入れ、許可する操作を選び、セットアップするAI アプリにチェックを入れます。
4. AI アプリを再起動し、たとえば「今日、受信トレイで対応が必要なものはありますか？」と尋ねます。

各システムでの詳しい手順、他のAI アプリとの接続方法、アップグレード方法、アンインストール方法については、INSTALL.mdをご覧ください。

既知の制限

• テキスト検索には、メールがコンピューターに保存されている必要があります。 メッセージ本文を検索すると、Thunderbird が全文をダウンロード済みのメッセージのみが見つかります。IMAP アカウントの場合は、アカウントの「同期とディスク領域」の設定で「このアカウントのメッセージをこのコンピューターに保存する」を有効にしてください。
• テキスト検索では大文字と小文字が区別されます。Thunderbird の検索仕様によるものです。検索結果は新しい順に表示されます。検索に時間がかかる場合は約 10 秒で中断し、見つかった結果と検索範囲を絞り込む方法を示すメモを返します。
• 「添付ファイルあり」は、確認する時間がなかった場合、検索結果で不明になることがあります。
• リクエストごとに時間制限があります。 多数のメッセージを一度に変更するリクエスト（既読にする、タグを付ける、移動するなど）で Thunderbird の処理が遅い場合は、処理できたメッセージと失敗したメッセージを報告します。
• 返信と転送の下書きは、スレッド情報を保持したまま「下書き」に保存されます。送信すると、Thunderbird はアカウントごとの設定に従って送信済みのコピーを保存します。すべてのアカウントの種類でテストしたわけではありません。
• 直接送信で受け付けられるのは、単純なアドレスのみです。@ より前には英字、数字、.、_、+、- を使用でき、ドメインは通常の形式である必要があります。それ以外のアドレスには下書きを作成してください。その理由については SECURITY.md をご覧ください。
• ホストにはまだコード署名がないため、インストール時に Windows と macOS で警告が表示されます。リリースページにあるアドオンにも署名はありません。Thunderbird ではファイルから署名なしアドオンをインストールでき、addons.thunderbird.net に掲載されると署名されます。

リンク

• INSTALL.md：インストール、AI アプリとの接続、アップグレード、アンインストール
• SECURITY.md：脅威モデル、保護措置、既知の制限、脆弱性の報告方法
• PRIVACY.md：データの送信先
• CONTRIBUTING.md：ビルド、テスト、貢献方法
• docs/PLATFORMS.md：各システムでテスト済みの内容

このプロジェクトを支援する

MCP for Thunderbird は、Noiz が提供するフリーソフトウェアです。役に立った場合、開発を支援する主な方法は Monero（XMR）での寄付です。

44BtMn9izxH8mK2yFbSdY6Di7TNobkLbnHdZ6gZQjukCME5vsNhtPRtH4TcVkDHKHLhSpAJbsjv8gCdYuSZVMpXgMkUC1hV

バグの報告、修正の送付、リポジトリへのスター付けでも支援できます。

ライセンスとクレジット

MCP for Thunderbird は、Wade J. Beckett（GitHub の wadejbeckett）が Mozilla Public License 2.0（LICENSE）のもとで公開しています。

アドオンの一部と SECURITY.md の脅威モデルは、MIT License のもとで使用している Vitalii Ionov の thunderbird-cli を参考にしています。NOTICE に該当するファイルを記載し、そのライセンスを保持しています。ホストは MIT および BSD ライセンスの Go ライブラリにリンクしています。THIRD_PARTY_LICENSES にそれらの通知を記載しており、各ホストパッケージに同梱しています。

Thunderbird は Mozilla Foundation の商標です。Claude、Codex、Cursor はそれぞれ Anthropic、OpenAI、Anysphere の製品名です。ここでは MCP for Thunderbird が対応するアプリを示す目的でのみ記載しており、これらの企業が MCP for Thunderbird を開発、推奨、または提携しているわけではありません。