thunderbird-cli

通过 Mozilla Thunderbird 为 Claude（及其他 AI 智能体）提供对你电子邮件的完整访问权限。

为什么选择它

IMAP 库迫使你管理凭据、OAuth 流程和同步状态——这在 AI 智能体环境中非常危险。Thunderbird 已经解决了所有这些问题。 该工具将 Thunderbird 视为事实来源，并将每一项功能公开为 CLI 命令或 MCP 工具，因此 AI 智能体可以在不接触任何密码的情况下读取、搜索和编写电子邮件。

经过大规模测试：22 个账户，24.9 万多封邮件，8.6 万多封未读邮件——全部通过单个 CLI 实时管理。

Related MCP server: Thunderbird MCP

功能特性

• 🔐 零凭据暴露 — 所有 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

Claude 的配套技能

随 MCP 服务器附带一个 Claude Skill。它教会 Claude 如何高效使用这 12 个电子邮件工具——包括 Token 高效的字段选择、默认草稿的安全机制、在操作链接前检查信任元数据，以及常见工作流的配方。从 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 来处理你的凭据和账户状态。 该工具将其呈现为机器可读的 API，而无需你在其他任何地方重新配置 IMAP/SMTP。

文档

贡献

欢迎贡献。请先开启一个 Issue 来讨论非琐碎的更改。查看 CONTRIBUTING.md 了解本地开发设置和 80 个测试套件。

许可证

MIT — 见 LICENSE