thunderbird-cli

Mozilla Thunderbird를 통해 Claude(및 기타 AI 에이전트)에게 이메일에 대한 완전한 접근 권한을 부여하세요.

목적

IMAP 라이브러리는 자격 증명, OAuth 흐름, 동기화 상태를 직접 관리해야 하므로 AI 에이전트 환경에서는 위험할 수 있습니다. Thunderbird는 이미 이 모든 문제를 해결하고 있습니다. 이 도구는 Thunderbird를 진실의 원천(source of truth)으로 삼아 모든 기능을 CLI 명령어 또는 MCP 도구로 노출하므로, AI 에이전트가 비밀번호를 건드리지 않고도 이메일을 읽고, 검색하고, 작성할 수 있습니다.

대규모 테스트 완료: 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번에 참석하겠다고 답장하고 초안으로 저장해줘" "메시지 245번의 PDF 첨부 파일을 다운로드해줘"

전체 MCP 가이드: mcp/README.md

Claude를 위한 컴패니언 스킬

MCP 서버와 함께 Claude Skill이 제공됩니다. 이 스킬은 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에 자격 증명과 계정 상태를 맡기고 계십니다. 이 도구는 다른 곳에서 IMAP/SMTP를 다시 설정할 필요 없이 해당 데이터를 기계가 읽을 수 있는 API로 노출합니다.

문서

기여

기여를 환영합니다. 사소하지 않은 변경 사항은 먼저 이슈를 열어 논의해 주세요. 로컬 개발 설정 및 80개 테스트 제품군은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT — LICENSE 참조