跳到主要内容

Agentmail

通过 AgentMail 为 Agent 提供专属电子邮件收件箱。使用 Agent 专属电子邮件地址（例如 aigenlabs-agent@agentmail.to）自主发送、接收和管理电子邮件。

Skill 元数据​

来源可选 — 使用 aigenlabs skills install official/email/agentmail 安装
路径optional-skills/email/agentmail
版本1.0.0
平台linux, macos, windows
标签email, communication, agentmail, mcp

参考：完整 SKILL.md​

信息

以下是 AigenLabs 在触发此 skill 时加载的完整 skill 定义。这是 skill 激活时 Agent 所看到的指令内容。

AgentMail — Agent 专属电子邮件收件箱

前置要求​

  • AgentMail API 密钥（必需）— 在 https://console.agentmail.to 注册（免费套餐：3 个收件箱，每月 3,000 封邮件；付费套餐起价 $20/月）
  • Node.js 18+（用于 MCP 服务器）

使用场景​

在以下情况下使用此 skill：

  • 为 Agent 提供专属电子邮件地址
  • 代表 Agent 自主发送电子邮件
  • 接收并读取传入邮件
  • 管理邮件线程和对话
  • 通过电子邮件注册服务或进行身份验证
  • 通过电子邮件与其他 Agent 或人类进行通信

此 skill 不适用于读取用户的个人邮件（请使用 himalaya 或 Gmail）。 AgentMail 为 Agent 提供独立的身份和收件箱。

配置​

1. 获取 API 密钥​

2. 配置 MCP 服务器​

添加至 ~/.aigenlabs/config.yaml（粘贴实际密钥 — MCP 环境变量不会从 .env 展开）：

mcp_servers:
  agentmail:
    command: "npx"
    args: ["-y", "agentmail-mcp"]
    env:
      AGENTMAIL_API_KEY: "am_your_key_here"

3. 重启 AigenLabs​

aigenlabs

所有 11 个 AgentMail 工具现已自动可用。

可用工具（通过 MCP）​

工具描述
list_inboxes列出所有 Agent 收件箱
get_inbox获取特定收件箱的详细信息
create_inbox创建新收件箱（获得真实电子邮件地址）
delete_inbox删除收件箱
list_threads列出收件箱中的邮件线程
get_thread获取特定邮件线程
send_message发送新邮件
reply_to_message回复已有邮件
forward_message转发邮件
update_message更新邮件标签/状态
get_attachment下载邮件附件

操作流程​

创建收件箱并发送邮件​

  1. 创建专属收件箱：
    • 使用 create_inbox 并指定用户名（例如 aigenlabs-agent）
    • Agent 获得地址：aigenlabs-agent@agentmail.to
  2. 发送邮件：
    • 使用 send_message，传入 inbox_id、to、subject、text
  3. 检查回复：
    • 使用 list_threads 查看传入对话
    • 使用 get_thread 读取特定线程

检查传入邮件​

  1. 使用 list_inboxes 查找收件箱 ID
  2. 使用 list_threads 并传入收件箱 ID 查看对话
  3. 使用 get_thread 读取线程及其消息

回复邮件​

  1. 使用 get_thread 获取线程
  2. 使用 reply_to_message，传入消息 ID 和回复内容

示例工作流​

注册服务：

1. create_inbox (username: "signup-bot")
2. 使用该收件箱地址在服务上注册
3. list_threads 检查验证邮件
4. get_thread 读取验证码

Agent 对人类的外发联系：

1. create_inbox (username: "aigenlabs-outreach")
2. send_message (to: user@example.com, subject: "Hello", text: "...")
3. list_threads 检查回复

注意事项​

  • 免费套餐限制为 3 个收件箱，每月 3,000 封邮件
  • 免费套餐邮件来自 @agentmail.to 域名（付费套餐支持自定义域名）
  • MCP 服务器需要 Node.js（18+）（npx -y agentmail-mcp）
  • 必须安装 mcp Python 包：pip install mcp
  • 实时入站邮件（webhook）需要公网服务器 — 个人使用时建议改用 list_threads 轮询配合 cronjob

验证​

配置完成后，使用以下命令测试：

aigenlabs --toolsets mcp -q "Create an AgentMail inbox called test-agent and tell me its email address"

应返回新收件箱的地址。

参考资料​