Skip to main content
Glama

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 + 监控规则 + 触发次数

Related MCP server: @aiwerk/mcp-server-imap

环境变量

变量

必需

描述

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,则将其标记为已读。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables AI models to read, search, and send emails via IMAP and SMTP protocols. It supports various providers like Gmail and Outlook, allowing for tasks such as retrieving unread messages, searching by sender, and managing mailbox folders.
      -
    • A
      license
      B
      quality
      C
      maintenance
      Universal IMAP/SMTP MCP server that works with any email provider, providing tools to read, search, send, and manage emails.
      10
      242 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that enables email management (send, read, search, delete, etc.) via IMAP/SMTP, compatible with Gmail, Outlook, Yahoo, iCloud, and other standard mail servers.
      11
      39 PyPI
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for reading and sending emails via IMAP and SMTP, designed for Zimbra and any standard mail host.
      12 npm
      1
      ISC