imap-mcp

MCP-клиент IMAP. Читайте почту из почтового ящика Dovecot / Synology MailPlus и, при необходимости, запускайте вебхуки при поступлении новых соответствующих сообщений — замена ненадежной OAuth-авторизации Gmail для триггеров автоматизации.

Инструменты

Инструмент	Описание
`list_unread(mailbox, limit)`	Сводка непрочитанных сообщений
`search(criteria, mailbox, limit)`	Необработанный IMAP SEARCH
`fetch(uid, mailbox)`	Полное сообщение (заголовки + текст + html)
`mark_read(uid, mailbox)`	Установка флага `\Seen`
`move(uid, source, dest)`	Перемещение в другую папку
`list_folders()`	Все папки
`get_status()`	IMAP ping + правила отслеживания + счетчик срабатываний

Переменные окружения

Переменная	Обязательно	Описание
`IMAP_HOST`	✓	Сервер (например, `192.168.68.61`)
`IMAP_PORT`		По умолчанию `993`
`IMAP_SSL`		`true` (по умолчанию) или `false`
`IMAP_USERNAME`	✓	Имя учетной записи Synology, не email
`IMAP_PASSWORD`	✓
`IMAP_DEFAULT_MAILBOX`		По умолчанию `INBOX`
`WATCHES_JSON`		Встроенный JSON-массив правил отслеживания
`WATCHES_FILE`		Путь к JSON-файлу (по умолчанию `/data/watches.json`)
`POLL_INTERVAL_SECS`		По умолчанию `30`
`PORT`		Порт MCP-сервера (по умолчанию `38105`)

Правила отслеживания

[
  {
    "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
  }
]

При запуске наблюдатель «подготавливает» каждое правило с существующими соответствующими UID, поэтому срабатывают только новые письма, полученные после загрузки. Каждые POLL_INTERVAL_SECS он повторно выполняет критерии каждого правила и отправляет POST-запрос с соответствующими сообщениями (полное тело) на webhook_url в формате { "rule": "...", "mailbox": "...", "message": {...} }. После успешного POST-запроса он либо перемещает сообщение в move_to, либо помечает его как прочитанное, если указано mark_read.