thunderbird-cli

thunderbird-cli

Mozilla Thunderbird を通じて、Claude やほかの AI エージェントからメールにフルアクセスできるようにします。

理由

IMAP ライブラリでは、認証情報、OAuth フロー、同期状態を管理する必要があり、AI エージェントの利用環境では危険です。Thunderbird はすでにそのすべてを解決しています。 このツールは Thunderbird を信頼できる情報源として扱い、すべての機能を CLI コマンドまたは MCP ツールとして公開するため、AI エージェントはパスワードに一切触れることなくメールを読んだり、検索したり、送信したりできます。

大規模環境でテスト済みです：22 アカウント、249,000 件以上のメッセージ、86,000 件以上の未読メールを、単一の CLI からすべてリアルタイムに管理できます。

特長

• 🔐 認証情報の露出ゼロ — IMAP/SMTP はすべて Thunderbird 内に保持されます
• 🤖 Claude Desktop に対応 — MCP ツール 12 個、設定は 1 行
• 📨 CLI コマンド 38 個 — 読み取り、検索、作成、返信、一括操作、フォルダーの CRUD、添付ファイル
• 🛡️ デフォルトで安全 — 作成、返信、転送は下書きとして保存され、完全削除には --confirm が必要です
• 🎯 トークンを最適化 — --fields による選択、--compact モード、--max-body による切り詰め
• 🏠 ローカルホスト限定 — クラウドなし、テレメトリーなし。マシンの外にデータは送信されません
• ✅ Thunderbird 128 以降 — addons.thunderbird.net で署名・承認済み
• 🧪 テスト 80 件 — CLI／ブリッジのテスト 46 件、MCP 統合テスト 34 件

クイックスタート

# 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 が提供されています。このスキルは、12 個のメールツールの効果的な使い方を Claude に教えます。トークン効率のよいフィールド選択、下書きをデフォルトとする安全性、リンクに対して操作する前の信頼メタデータの確認、一般的なワークフローのレシピなどが含まれます。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 は最も安全なデフォルト設定と、最も効率的な応答形式を自動的に使用します。

仕組み

コンポーネント	役割
拡張機能 (extension/)	Thunderbird WebExtension。messenger.* API を呼び出します。ルートハンドラー 43 個。
ブリッジ (bridge/)	ステートレスな HTTP↔WebSocket プロキシデーモン。ビジネスロジックはありません。
CLI (cli/)	tb コマンド — 38 個のコマンド。軽量な HTTP クライアント。JSON 出力。
MCP (mcp/)	tb-mcp サーバー — Claude Desktop 向けに厳選されたツール 12 個。

Thunderbird が信頼できる情報源です。CLI はメールデータをキャッシュも保存もしません。

比較

ツール	認証情報	AI エージェント対応	作成／送信	複数アカウント	実行環境
thunderbird-cli	Thunderbird 内に保持	✅ CLI + MCP、JSON 出力	✅ 下書き／開く／送信	✅ Thunderbird の任意のアカウント	Node.js
生の IMAP ライブラリ（imapflow、imaplib）	自分で管理	自分で接続	SMTP、別途必要	アカウントごとに手動	さまざま
notmuch	使用する MUA 経由	CLI のみ、テキスト出力	❌ 閲覧のみ	設定経由	C
mu / mu4e	使用する MUA 経由	CLI のみ、sexp／テキスト	❌ 閲覧のみ	設定経由	C
himalaya	設定ファイル内	✅ CLI、JSON 出力	✅	✅	Rust
mutt / neomutt	muttrc 内	❌ 対話型 TUI	✅	設定経由	C

このツールの位置づけ：すでに認証情報とアカウント状態を Thunderbird に任せている方に向けたものです。 IMAP／SMTP を別の場所で再設定することなく、マシンで読み取り可能な API として利用できます。

ドキュメント

ドキュメント	内容
docs/SETUP.md	インストール、バックグラウンドサービス、Docker、トラブルシューティング
docs/COMMANDS.md	38 個すべての CLI コマンドの完全なリファレンス
docs/CLAUDE.md	AI エージェント向けクイックリファレンス + セキュリティルール
skills/thunderbird-cli/SKILL.md	Claude 用コンパニオンスキル — レシピ、安全なデフォルト設定、トークンのパターン
mcp/README.md	Claude Desktop との統合ガイド
AGENTS.md	このコードベースを編集する AI エージェント向けガイド
SPEC.md	技術仕様の全文
SECURITY.md	脅威モデル、プロンプトインジェクション対策
CONTRIBUTING.md	開発環境のセットアップ、コードスタイル、PR の手順
CHANGELOG.md	リリースノート

コントリビューション

コントリビューションを歓迎します。大規模な変更については、まず Issue を作成してご相談ください。ローカル開発環境のセットアップと 80 件のテストスイートについては、CONTRIBUTING.md をご覧ください。

ライセンス

MIT — LICENSE をご覧ください