imap-mcp

MCP de cliente IMAP. Lee correos de un buzón Dovecot / Synology MailPlus y, opcionalmente, dispara webhooks cuando llegan nuevos mensajes coincidentes; reemplaza la frágil autenticación OAuth de Gmail para disparadores de automatización.

Herramientas

Herramienta	Descripción
`list_unread(mailbox, limit)`	Resúmenes de mensajes no leídos
`search(criteria, mailbox, limit)`	BÚSQUEDA IMAP sin procesar
`fetch(uid, mailbox)`	Mensaje completo (encabezados + texto + html)
`mark_read(uid, mailbox)`	Establecer la marca `\Seen`
`move(uid, source, dest)`	Mover a otra carpeta
`list_folders()`	Todas las carpetas
`get_status()`	Ping IMAP + reglas de vigilancia + contador de disparos

Entorno

Variable	Requerido	Descripción
`IMAP_HOST`	✓	Servidor (ej. `192.168.68.61`)
`IMAP_PORT`		Predeterminado `993`
`IMAP_SSL`		`true` (predeterminado) o `false`
`IMAP_USERNAME`	✓	Nombre de cuenta de Synology, no correo electrónico
`IMAP_PASSWORD`	✓
`IMAP_DEFAULT_MAILBOX`		Predeterminado `INBOX`
`WATCHES_JSON`		Matriz JSON en línea de reglas de vigilancia
`WATCHES_FILE`		Ruta al archivo JSON (predeterminado `/data/watches.json`)
`POLL_INTERVAL_SECS`		Predeterminado `30`
`PORT`		Puerto del servidor MCP (predeterminado `38105`)

Reglas de vigilancia

[
  {
    "name": "garmin-livetrack",
    "mailbox": "INBOX",
    "criteria": "FROM \"noreply@garmin.com\" SUBJECT \"LiveTrack\" UNSEEN",
    "webhook_url": "http://host.docker.internal:5678/webhook/livetrack-mail",
    "mark_read": true,
    "move_to": null
  }
]

Al iniciarse, el vigilante "prepara" cada regla con los UID coincidentes existentes, por lo que solo se disparan los correos nuevos después del arranque. Cada POLL_INTERVAL_SECS vuelve a ejecutar los criterios de cada regla y envía los mensajes coincidentes (cuerpo completo) mediante POST a webhook_url como { "rule": "...", "mailbox": "...", "message": {...} }. Tras un POST exitoso, mueve el mensaje a move_to o lo marca como leído si se especifica mark_read.