@fuyouai/email-mcp

通过 MCP 读写邮箱：收信用 IMAP，发信用 SMTP。默认参数适配腾讯企业邮箱（exmail.qq.com）。

工具

| Tool | 说明 | |------|------| | list_folders | 列出文件夹 | | list_messages | 列出邮件摘要 | | search_messages | 按条件搜索 | | get_message | 读取单封正文与附件信息 | | send_message | 发送邮件（环境变量 SMTP_ENABLED=false 时不注册） |

要求

• Node.js 18+
• 邮箱已开启 IMAP；发信需开启 SMTP
• 腾讯企业邮开启安全登录时，使用客户端专用密码（IMAP 说明）

在 Cursor 中使用

npx -y @fuyouai/email-mcp

mcp.json 示例（把账号与密码换成你自己的；密码不要提交到仓库）：

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": ["-y", "@fuyouai/email-mcp"],
      "env": {
        "IMAP": "imap.exmail.qq.com:993",
        "MAIL_USER": "[email protected]",
        "MAIL_PASSWORD": "客户端专用密码",
        "IMAP_SECURE": "true",
        "SMTP": "smtp.exmail.qq.com:465",
        "SMTP_SECURE": "true",
        "SMTP_ENABLED": "true"
      }
    }
  }
}

安装到全局后，可执行 CLI：email-mcp。

环境变量

| 变量 | 说明 | 默认 | |------|------|------| | IMAP | 收信 host:port | imap.exmail.qq.com:993 | | MAIL_USER | 登录邮箱（收/发共用） | 必填 | | MAIL_PASSWORD | 密码或客户端专用密码 | 必填 | | IMAP_SECURE | IMAP 使用 TLS | true | | MAX_BODY_CHARS | 读信正文最大长度 | 8000 | | SMTP | 发信 host:port | smtp.exmail.qq.com:465 | | SMTP_SECURE | SMTP 使用 TLS | true | | SMTP_ENABLED | 是否注册发信工具 | true | | SMTP_USER / SMTP_PASSWORD | 发信账号与收信不同时填写 | 默认同 MAIL_* | | SMTP_FROM | 发件人显示地址 | 默认同发信登录账号 |

海外机房可将 IMAP / SMTP 改为 hwimap.exmail.qq.com:993、hwsmtp.exmail.qq.com:465。

send_message 参数示例

{
  "to": "[email protected]",
  "subject": "会议提醒",
  "text": "明天下午 3 点开会。"
}

多个收件人："to": "[email protected], [email protected]" 或 "to": ["[email protected]", "[email protected]"]。text 与 html 至少填一项。