@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": "you@yourcompany.com",
        "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": "colleague@company.com",
  "subject": "会议提醒",
  "text": "明天下午 3 点开会。"
}

多个收件人："to": "a@x.com, b@x.com" 或 "to": ["a@x.com", "b@x.com"]。text 与 html 至少填一项。