thunderbird-cli

Proporciona a Claude (y otros agentes de IA) acceso total a tu correo electrónico a través de Mozilla Thunderbird.

Por qué

Las bibliotecas IMAP te obligan a gestionar credenciales, flujos OAuth y estados de sincronización, lo cual es peligroso en el contexto de un agente de IA. Thunderbird ya resuelve todo eso. Esta herramienta trata a Thunderbird como la fuente de verdad y expone cada capacidad como un comando CLI o una herramienta MCP, para que los agentes de IA puedan leer, buscar y escribir correos electrónicos sin tocar nunca una contraseña.

Probado a gran escala: 22 cuentas, más de 249,000 mensajes, más de 86,000 sin leer, todo gestionado en vivo a través de una única CLI.

Related MCP server: Thunderbird MCP

Características

• 🔐 Cero exposición de credenciales — todo el tráfico IMAP/SMTP permanece en Thunderbird

• 🤖 Listo para Claude Desktop — 12 herramientas MCP, configuración de una sola línea

• 📨 38 comandos CLI — leer, buscar, redactar, responder, operaciones masivas, CRUD de carpetas, archivos adjuntos

• 🛡️ Seguro por defecto — redactar/responder/reenviar se guardan como borradores; la eliminación permanente requiere --confirm

• 🎯 Optimizado para tokens — selección --fields, modo --compact, truncamiento --max-body

• 🏠 Solo localhost — sin nube, sin telemetría, nada sale de tu máquina

• ✅ Thunderbird 128+ — firmado y aprobado en addons.thunderbird.net

• 🧪 80 pruebas — 46 pruebas de CLI/puente + 34 pruebas de integración MCP

Inicio rápido

# 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

Guía de configuración completa (incluyendo servicio en segundo plano, Docker, solución de problemas): docs/SETUP.md

Uso

# 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

Referencia completa de comandos: docs/COMMANDS.md

Uso con Claude Desktop

Añádelo a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

Reinicia Claude Desktop. Ahora pregunta:

*"¿Cuántos correos electrónicos sin leer tengo?" *"Busca facturas de AWS del mes pasado" *"Responde al mensaje 118 diciendo que asistiré — guárdalo como borrador" "Descarga el archivo adjunto PDF del mensaje 245"

Guía completa de MCP: mcp/README.md

Habilidad complementaria para Claude

Una Habilidad de Claude se incluye junto con el servidor MCP. Enseña a Claude cómo usar bien las 12 herramientas de correo electrónico: selección de campos eficiente en tokens, seguridad mediante borradores por defecto, verificación de metadatos de confianza antes de actuar sobre enlaces, recetas para flujos de trabajo comunes. Instálala desde 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

Sin la habilidad, el MCP sigue funcionando. Con ella, Claude utiliza automáticamente los valores predeterminados más seguros y las formas de respuesta más eficientes.

Cómo funciona

Thunderbird es la fuente de verdad. La CLI nunca almacena en caché ni guarda datos de correo electrónico.

Comparativa

El nicho: ya confías en Thunderbird con tus credenciales y el estado de tu cuenta. Esta herramienta expone eso como una API legible por máquina sin pedirte que vuelvas a configurar IMAP/SMTP en ningún otro lugar.

Documentación

Contribuciones

Las contribuciones son bienvenidas. Por favor, abre un issue primero para discutir cambios no triviales. Consulta CONTRIBUTING.md para la configuración de desarrollo local y la suite de 80 pruebas.

Licencia

MIT — ver LICENSE