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 — 12 个 MCP 工具，一行配置即可使用

• 📨 38 个 CLI 命令 — 读取、搜索、撰写、回复、批量操作、文件夹 CRUD、附件处理

• 🛡️ 默认安全 — 撰写/回复/转发操作保存为草稿；永久删除需要 --confirm 确认

• 🎯 Token 优化 — 支持 --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 来处理你的凭据和账户状态。 该工具将其呈现为机器可读的 API，而无需你在其他任何地方重新配置 IMAP/SMTP。

文档

贡献

欢迎贡献。请先提交 Issue 讨论非琐碎的更改。请参阅 CONTRIBUTING.md 了解本地开发设置和 80 个测试套件。

许可证

MIT — 见 LICENSE