Correo Despacho

MCP de correo IMAP/SMTP para el despacho De la Torre (abogadosdelatorre.com). Permite a Claude leer, buscar, organizar y (opcionalmente) enviar email. Multi-cuenta, con candados de seguridad. Mismo patrón que dolibarr-despacho-mcp y centralita-vpbx-mcp.

Herramientas

Lectura (siempre disponible)

Tool	Qué hace
mail_list_accounts	Cuentas configuradas (sin contraseñas)
mail_list_folders	Carpetas/buzones de una cuenta
mail_list_messages	Lista mensajes de una carpeta (recientes primero, paginado)
mail_search	Busca por remitente/destinatario/asunto/texto/fechas
mail_get_message	Lee un mensaje completo + adjuntos
mail_download_attachment	Descarga un adjunto a disco
mail_unread_overview	"¿Qué hay nuevo?" en todas las cuentas

Escritura de buzón — candado MAIL_ENABLE_WRITES

Tool	Qué hace
mail_mark_read / mail_mark_unread	Marca leído / no leído
mail_flag / mail_unflag	Destaca / quita destacado
mail_move	Mueve a otra carpeta
mail_delete	Envía a la Papelera (reversible) — nunca borra de forma permanente
mail_create_draft	Crea un borrador (no lo envía)

Envío — candado MAIL_ENABLE_SEND

Tool	Qué hace
mail_send	Envía un correo nuevo
mail_reply	Responde a un mensaje (mantiene hilo)

Configuración (variables de entorno)

• MAIL_ACCOUNTS — JSON con las cuentas (inline), o
• MAIL_CONFIG_PATH — ruta a un accounts.json (recomendado, fuera del config).
• MAIL_ENABLE_WRITES — true/false (def. false).
• MAIL_ENABLE_SEND — true/false (def. false).
• MAIL_ATTACHMENT_DIR — carpeta donde guardar adjuntos descargados.
• MAIL_TLS_STRICT — true para validar el certificado TLS (def. false; cPanel compartido suele tener el cert del servidor, no del dominio).
• MCP_TRANSPORT — stdio (local, def.) o http.

Formato de cada cuenta en accounts.json (ver accounts.example.json):

[
  { "name": "juridico", "email": "[email protected]",
    "password": "…", "host": "abogadosdelatorre.com",
    "imap_port": 993, "smtp_port": 465, "default": true }
]

host se usa para IMAP y SMTP; si se omite, se deriva del dominio del email. Puertos por defecto: IMAP 993 (SSL), SMTP 465 (SSL).

Build y prueba

npm install
npm run build      # compila a dist/
npm run smoke      # arnés: arranca, lista tools y prueba mail_list_accounts

Instalar en Claude Desktop

node add-to-claude.cjs   # hace backup del config y registra "correo-despacho"

Luego reinicia Claude Desktop. Las credenciales se leen de MAIL_CONFIG_PATH.

Seguridad

• Borrado = Papelera: mail_delete mueve a Trash; nunca hace expunge permanente.
• Envío OFF por defecto: enviar correos de un despacho es delicado; actívalo con MAIL_ENABLE_SEND=true cuando quieras.
• Contraseñas fuera del repo (accounts.json está en .gitignore).