correo-despacho-mcp

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": "juridico@abogadosdelatorre.com",
    "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).