thunderbird-cli

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

なぜこれを使うのか

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

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

Related MCP server: Thunderbird MCP

特徴

• 🔐 認証情報の露出ゼロ — すべての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

Claude用コンパニオン・スキル

MCPサーバーには Claude Skill が同梱されています。これはClaudeに対して、12個のメールツールを効果的に使用する方法（トークン効率の良いフィールド選択、デフォルトでの下書き保存による安全性、リンクを操作する前の信頼メタデータの確認、一般的なワークフローのレシピなど）を教えるものです。skills/thunderbird-cli/ からインストールしてください：

# Claude Code
cp -r skills/thunderbird-cli ~/.claude/skills/

# Claude.ai — zip and upload via Settings → Capabilities → Skills
cd skills && zip -r thunderbird-cli.zip thunderbird-cli

スキルがなくてもMCPは動作しますが、スキルを導入することで、Claudeは自動的に最も安全なデフォルト設定と効率的な応答形式を使用するようになります。

仕組み

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

他のツールとの比較

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

ドキュメント

貢献

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

ライセンス

MIT — LICENSE を参照