imap-mcp

IMAP 客户端 MCP。从 Dovecot / Synology MailPlus 邮箱读取邮件，并可在收到匹配的新邮件时触发 Webhook —— 用于替代脆弱的 Gmail OAuth 自动化触发器。

工具

工具	描述
`list_unread(mailbox, limit)`	未读邮件摘要
`search(criteria, mailbox, limit)`	原始 IMAP 搜索
`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`	✓	群晖账户名，非电子邮件地址
`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，它会重新运行每条规则的条件，并将匹配的邮件（完整正文）以 { "rule": "...", "mailbox": "...", "message": {...} } 的格式 POST 到 webhook_url。在成功 POST 后，它会将邮件移动到 move_to 指定的文件夹，或者如果设置了 mark_read，则将其标记为已读。