thunderbird-cli

Предоставьте Claude (и другим ИИ-агентам) полный доступ к вашей электронной почте через Mozilla Thunderbird.

Зачем это нужно

Библиотеки IMAP заставляют вас управлять учетными данными, потоками OAuth и состоянием синхронизации — это опасно в контексте ИИ-агентов. Thunderbird уже решает все эти задачи. Этот инструмент использует Thunderbird как единственный источник истины и предоставляет все возможности в виде команд CLI или инструментов MCP, поэтому ИИ-агенты могут читать, искать и писать письма, никогда не касаясь паролей.

Протестировано в масштабе: 22 учетные записи, 249 000+ сообщений, 86 000+ непрочитанных — все управляется в реальном времени через единый CLI.

Related MCP server: Thunderbird MCP

Возможности

• 🔐 Нулевое раскрытие учетных данных — все IMAP/SMTP остается в Thunderbird

• 🤖 Готовность к работе с Claude Desktop — 12 инструментов MCP, настройка в одну строку

• 📨 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 (~/Library/Application Support/Claude/claude_desktop_config.json в macOS):

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

Перезапустите Claude Desktop. Теперь спросите:

"Сколько у меня непрочитанных писем?" "Найди счета от AWS за прошлый месяц" "Ответь на сообщение 118, что я буду присутствовать — сохрани как черновик" "Скачай PDF-вложение из сообщения 245"

Полное руководство по MCP: mcp/README.md

Дополнительный навык для Claude

Навык Claude (Claude Skill) поставляется вместе с сервером MCP. Он обучает 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 свои учетные данные и состояние аккаунта. Этот инструмент предоставляет это в виде машиночитаемого API, не требуя от вас перенастройки IMAP/SMTP где-либо еще.

Документация

Участие в разработке

Приветствуются любые вклады. Пожалуйста, сначала откройте issue, чтобы обсудить нетривиальные изменения. См. CONTRIBUTING.md для настройки локальной разработки и набора из 80 тестов.

Лицензия

MIT — см. LICENSE