thunderbird-cli

Mozilla Thunderbirdを通じて、Claude（およびその他のAIエージェント）にメールへの完全なアクセス権を付与します。

理由

IMAPライブラリを使用すると、認証情報、OAuthフロー、同期状態を自分で管理する必要があり、AIエージェントのコンテキストでは危険を伴います。Thunderbirdはすでにこれらすべてを解決しています。 このツールはThunderbirdを信頼できる唯一の情報源（Source of Truth）として扱い、すべての機能をCLIコマンドまたはMCPツールとして公開するため、AIエージェントはパスワードに触れることなくメールの読み取り、検索、書き込みを行うことができます。

大規模環境でのテスト済み：22アカウント、249,000通以上のメッセージ、86,000通以上の未読メール — すべて単一のCLIからライブ管理可能です。

特徴

• 🔐 認証情報の露出ゼロ — すべてのIMAP/SMTP通信はThunderbird内で完結

• 🤖 Claude Desktop対応 — 12個のMCPツール、1行の設定で利用可能

• 📨 38個のCLIコマンド — 読み取り、検索、作成、返信、一括操作、フォルダCRUD、添付ファイル操作

• 🛡️ デフォルトで安全 — 作成/返信/転送は下書きとして保存され、完全削除には --confirm が必要

• 🎯 トークン最適化 — --fields による選択、--compact モード、--max-body による切り詰め

• 🏠 ローカルホスト専用 — クラウドやテレメトリは一切なく、データはマシンから外部へ送信されません

• ✅ Thunderbird 128+ — addons.thunderbird.netで署名・承認済み

• 🧪 80個のテスト — 46個のCLI/ブリッジテスト + 34個のMCP統合テスト

クイックスタート

# 1. Install CLI + bridge from npm
npm install -g thunderbird-cli thunderbird-cli-bridge

# 2. Install the signed Thunderbird extension
#    Download: https://github.com/vitalio-sh/thunderbird-cli/releases/latest
#    Thunderbird → Add-ons → ⚙ → Install Add-on From File… → thunderbird_ai_bridge-*.xpi

# 3. Start the bridge daemon (keep running)
tb-bridge

# 4. Try it
tb health
tb stats

完全なセットアップガイド（バックグラウンドサービス、Docker、トラブルシューティングを含む）： docs/SETUP.md

使用方法

# How many unread across all accounts?
tb stats

# Find invoices from AWS in the last 30 days
tb search "invoice" --from aws --since 30d --fields id,author,subject,date

# Read a message (token-efficient — headers + text only, max 500 chars)
tb read 89900 --max-body 500

# Reply as draft (never auto-sends)
tb reply 89900 --body "Thanks, I'll review tomorrow"

# Download a PDF attachment
tb attachment-download 11 1.2 --output invoice.pdf

# Bulk archive old newsletters
tb bulk move "account1://INBOX" "account1://Archive" \
  --from "newsletter@" --older-than 30

完全なコマンドリファレンス： docs/COMMANDS.md

Claude Desktopでの使用

Claude Desktopの設定（macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "thunderbird": {
      "command": "npx",
      "args": ["-y", "thunderbird-cli-mcp"]
    }
  }
}

Claude Desktopを再起動します。以下のように質問してみてください：

"未読メールは何通ありますか？" "先月のAWSからの請求書を探して" "メッセージ118に『出席します』と返信して、下書きとして保存して" "メッセージ245のPDF添付ファイルをダウンロードして"

完全なMCPガイド： mcp/README.md

仕組み

Thunderbirdが信頼できる唯一の情報源です。CLIはメールデータをキャッシュしたり保存したりすることはありません。

比較

このツールのニッチ：あなたはすでにThunderbirdに認証情報とアカウント状態を預けています。 このツールは、他の場所でIMAP/SMTPを再設定させることなく、それを機械可読なAPIとして提供します。

ドキュメント

コントリビューション

コントリビューションを歓迎します。些細ではない変更については、まずIssueを開いて議論してください。ローカル開発環境の構築と80個のテストスイートについては CONTRIBUTING.md を参照してください。

ライセンス

MIT — LICENSE を参照