engagelab-email

EngageLab Agent Email MCP 服务

English | 简体中文

EngageLab Email 官方项目。

此仓库分发的是一个本地 stdio MCP 服务。它不提供托管的 OAuth 或 HTTP MCP 端点；请使用下方的安装命令在本地运行。

通过 AI Agent 发送、接收和回复电子邮件——使用 Model Context Protocol。

每个 Agent 都有自己的邮箱：一个真正可以发送和接收邮件的地址，邮件会按会话分组到线程中，让 Agent 掌握上下文。可与 Claude Desktop、Claude Code、Cursor、Cowork 以及任何兼容 MCP 的客户端配合使用。

{
  "mcpServers": {
    "engagelab-email": {
      "command": "npx",
      "args": ["-y", "@engagelabemail/mcp"],
      "env": { "ENGAGELAB_EMAIL_SECRET_KEY": "sk_sg_your_key" }
    }
  }
}

为什么选择它

大多数电子邮件 API 只能发送邮件。需要通过电子邮件进行对话的 Agent（例如处理支持、日程安排和审批）需要一个收件箱。

• 发送和接收——Agent 拥有专属邮箱，而不是外挂的解析 Webhook
• 支持线程——回复会归入相应会话，让 Agent 查看完整历史记录
• 沙盒模式——无需给真实用户发邮件，即可测试 Agent 工作流
• 只需一个环境变量——本地使用无需 OAuth 流程；区域会根据密钥推断

工具

	工具	功能
发现	list_mailboxes	列出邮箱；先调用此工具以获取 ID
发送	send_email	发送新邮件（text/html、cc/bcc、附件、沙盒）
	reply_email	回复邮件——收件人和线程会自动推断
接收	list_inbound_messages	列出收到的邮件，可按邮箱/关键词筛选
	get_message	按 UID 获取完整邮件详情
	check_new_messages	一次性轮询新邮件
线程	list_threads / get_thread / list_thread_messages	浏览会话

快速入门

Smithery / MCPB

对于本地 stdio 分发，请构建 MCPB 软件包：

npm run build:mcpb

软件包会生成在 dist/engagelab-agent-email.mcpb，可通过 Smithery 发布页面上传。

官方 MCP 注册表

EngageLab Agent Email 也已列入官方 MCP 注册表。使用该注册表的客户端可通过服务名称 io.github.Metaverse-Cloud/engagelab-email 找到它；底层 npm 软件包仍为 @engagelabemail/mcp。

1. 获取 Secret Key。 创建 EngageLab 账户，并在控制台生成密钥（格式为 sk_sg_xxx——前缀用于选择区域）。也可以使用 CLI：运行 engagelab-email-cli login，通过浏览器创建密钥。

2. 创建邮箱。 在控制台为 Agent 创建邮箱（共享子域名可立即使用；自定义域名需要进行 DNS 验证）。通过程序创建邮箱已列入路线图——如果 list_mailboxes 返回空结果，请参阅故障排除。

3. 注册服务。

Claude Desktop——将上方的 JSON 代码块添加到 claude_desktop_config.json。

Claude Code：

claude mcp add engagelab-email \
  -e ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_your_key \
  -- npx -y @engagelabemail/mcp

然后向 Agent 提出请求：

列出我的邮箱，然后从第一个邮箱向 [email protected] 发送一封邮件，告知对方发票已获批准。

支持机器人典型的 Agent 工作流：

check_new_messages()            → [messageUids]
get_message(uid)                → body, attachments
list_thread_messages(threadId)  → full conversation context
reply_email(uid, { text: ... }) → response lands in the same thread

配置

环境变量	必填	说明
ENGAGELAB_EMAIL_SECRET_KEY	是	以 sk_ 开头的 Secret Key
ENGAGELAB_EMAIL_BASE_URL	否	覆盖 API 基础 URL。根据密钥区域推断：sg → 新加坡，tr → 土耳其

限制：每封邮件最多 10 个附件，附件总大小不超过 10MB（在工具架构中以 base64 编码）。

故障排除

• list_mailboxes 返回空列表 — 你的账户尚无邮箱。请在 EngageLab 控制台中创建一个（参见快速入门步骤 2）。Agent 目前无法自行创建邮箱。
• 401 / code 100101 — Secret Key 错误或已撤销。请检查 ENGAGELAB_EMAIL_SECRET_KEY，并确认密钥的区域前缀（sk_sg_ / sk_tr_）与所用端点匹配。
• 无法确定 API 基础 URL — 无法识别密钥的区域前缀。请显式设置 ENGAGELAB_EMAIL_BASE_URL。
• 回复显示为新会话 — 请使用 reply_email（而非 send_email），以保留 In-Reply-To 标头和邮件线程。

路线图

• 用于零配置远程使用的托管 MCP（OAuth）
• 通过 Secret Key 以编程方式创建邮箱
• 为 check_new_messages 推送 Webhook（无需轮询）
• 基于 URL 的附件引用（上下文中不使用 base64）

从源代码运行

git clone https://github.com/Metaverse-Cloud/engagelab-email-mcp
cd engagelab-email-mcp
npm install && npm run build
ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_xxx node dist/index.cjs

相关内容

• EngageLab Agent Email CLI — 在终端中使用相同邮箱，并为 Agent 提供 --json 输出
• EngageLab Node SDK / Python SDK — 从代码发送邮件

许可证

MIT