vitalio-sh/thunderbird-cli

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

65 stars 14 forks 质量 80 趋势 28MIT

Repository Install

通过Mozilla Thunderbird，给Claude完全访问你的邮箱权限。CLI+MCP服务器用于AI代理。

概览

通过Mozilla Thunderbird，给Claude（以及其他AI代理）完全访问你的电子邮件。 IMAP库强制你管理凭证、OAuth流和同步状态——在AI代理环境中非常危险。该工具将Thunderbird视为真实源，并将所有能力作为CLI命令或MCP工具公开，使AI代理无需触及密码即可读取、搜索和写入邮件。大规模测试：——所有实时管理都通过一个CLI进行。 - 🔐 — 所有IMAP/SMTP都保留在Thunderbird中 - 🤖 — 12个MCP工具，一行配置 - 📨 — 读取、搜索、合成、回复、批量操作、文件夹CRUD、附件 - 🛡️ — 撰写/回复/转发保存为草稿;永久删除需要 --确认 - 🎯 --字段选择，--紧凑模式，--最大体截断 - 🏠 - - 无云，无遥测，机器无任何信息流出 - ✅ - - 在 addons.thunderbird 上签署并批准。

概述（AI 翻译）

通过 Mozilla Thunderbird 赋予 Claude（以及其他 AI 代理）对你邮件的完全访问权限。

为什么

IMAP库强制你管理凭证、OAuth流和同步状态——在AI代理环境中存在风险。**Thunderbird已经解决了所有这些问题。**该工具将Thunderbird视为真相源，并将所有能力暴露为CLI命令或MCP工具，因此AI代理无需触及密码即可读取、搜索和写入邮件。

大规模测试：22个账户，249,000+条消息，86,000+未读——全部通过单一CLI实时管理。

特色

🔐 零凭证暴露 — 所有IMAP/SMTP都保留在Thunderbird中
🤖 Claude Desktop ready — 12 个 MCP 工具，一行配置
📨 38 个 CLI 命令 — 读取、搜索、组合、回复、批量操作、文件夹 CRUD、附件
🛡️ 默认安全 — 生成/回复/转发为草稿;永久删除需要 --confirm
🎯 令牌优化 — --fields 选择，--compact 模式，--max-body 截断
🏠 仅本地主机 — 无云，无遥测，机器无任何信息
✅ 雷鸟128+ — 签署并批准 addons.thunderbird.net

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

thunderbird-cli

Give Claude (and other AI agents) full access to your email through Mozilla Thunderbird.

Why

IMAP libraries force you to manage credentials, OAuth flows, and sync state — dangerous in an AI-agent context. Thunderbird already solves all of that. This tool treats Thunderbird as the source of truth and exposes every capability as a CLI command or MCP tool, so AI agents can read, search, and write email without ever touching a password.

Tested at scale: 22 accounts, 249,000+ messages, 86,000+ unread — all managed live through a single CLI.

Features

🔐 Zero credential exposure — all IMAP/SMTP stays in Thunderbird
🤖 Claude Desktop ready — 12 MCP tools, one-line config
📨 38 CLI commands — read, search, compose, reply, bulk ops, folder CRUD, attachments
🛡️ Safe by default — compose/reply/forward save as drafts; permanent delete requires --confirm
🎯 Token-optimized — --fields selection, --compact mode, --max-body truncation
🏠 Localhost-only — no cloud, no telemetry, nothing leaves your machine
✅ Thunderbird 128+ — signed and approved on addons.thunderbird.net
🧪 80 tests — 46 CLI/bridge + 34 MCP integration tests

Quick Start

# 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

Full setup guide (including background service, Docker, troubleshooting): docs/SETUP.md

Usage

# 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

在 GitHub 查看完整 README

安装

npx -y thunderbird-cli-mcp

新手？先看 mcpskill.org 教程 →

配置

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