title: “Agentmail — Give the agent its own dedicated email inbox via AgentMail” sidebar_label: “Agentmail” description: “Give the agent its own dedicated email inbox via AgentMail”

{/* 此页面由 website/scripts/generate-skill-docs.py 根据技能的 SKILL.md 文件自动生成。请直接编辑源文件 SKILL.md，而非此页面。 */}

Agentmail

通过 AgentMail 为智能体配置专属的电子邮件收件箱。智能体可使用属于自己的邮箱地址（例如 hermes-agent@agentmail.to）自主发送、接收和管理邮件。

技能元数据


来源	可选 — 通过 `hermes skills install official/email/agentmail` 安装
路径	`optional-skills/email/agentmail`
版本	`1.0.0`
支持平台	linux、macos、windows
标签	`email`、`communication`、`agentmail`、`mcp`

参考：完整的 SKILL.md 文件

:::info 以下是当触发该技能时 Hermes 会加载的完整技能定义。智能体在技能处于激活状态时，看到的指令即为内容。: ::

AgentMail — 智能体专属电子邮件收件箱

前提条件

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

适用场景

在以下情况下可使用此技能：

为智能体配置专属的电子邮件地址
代表智能体自主发送邮件
接收并阅读收到的邮件
管理邮件对话和往来记录
通过邮件注册服务或进行身份验证
通过邮件与其他智能体或人类进行沟通

注意：此功能不可用于读取用户的个人邮件（此类需求请使用 himalaya 或 Gmail）。AgentMail 能为智能体提供独立的身份和收件箱。

设置步骤

1. 获取 API 密钥

访问 https://console.agentmail.to
创建账户并生成 API 密钥（密钥以 am_ 开头）

2. 配置 MCP 服务器

在 ~/.hermes/config.yaml 文件中添加相关配置（请粘贴实际的 API 密钥——MCP 环境变量不会从 .env 文件中读取）：

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

3. 重启 Hermes Agent

hermes

目前，全部11种AgentMail工具均已实现自动可用。

可用工具（通过MCP接口）

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

操作步骤

创建收件箱并发送邮件

创建专用收件箱：
- 使用create_inbox函数并指定用户名（例如hermes-agent）
- 代理将获得如下地址：hermes-agent@agentmail.to
发送邮件：
- 使用send_message函数，传入inbox_id、to、subject和text参数
查看回复：
- 使用list_threads查看收到的对话内容
- 使用get_thread读取特定的邮件线程

查看新邮件

使用list_inboxes查找您的收件箱ID
使用该收件箱ID配合list_threads查看对话记录
使用get_thread阅读特定线程及其邮件内容

回复邮件

使用get_thread获取目标邮件线程
使用reply_to_message函数，传入邮件ID及您的回复内容

实际应用示例

注册服务：

1. create_inbox (username: "signup-bot")
2. Use the inbox address to register on the service
3. list_threads to check for verification email
4. get_thread to read the verification code

智能体与人类的交互功能：

1. create_inbox (username: "hermes-outreach")
2. send_message (to: user@example.com, subject: "Hello", text: "...")
3. list_threads to check for replies

常见问题

免费套餐仅支持3个收件箱以及每月3,000封邮件
免费套餐下的邮件发送地址均为@agentmail.to域名（付费套餐则支持自定义域名）
MCP服务器需使用Node.js 18及以上版本运行（可通过npx -y agentmail-mcp命令安装）
必须安装Python的mcp包：pip install mcp
若需实时接收邮件（通过Webhook），则需要一台公网服务器——个人使用建议改用通过cronjob定时调用list_threads函数的方式

验证

设置完成后，可通过以下方式进行测试：

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

您应该会看到返回的新收件箱地址。

参考资料

AgentMail 文档：https://docs.agentmail.to/
AgentMail 控制台：https://console.agentmail.to
AgentMail MCP 代码库：https://github.com/agentmail-to/agentmail-mcp
定价信息：https://www.agentmail.to/pricing

Keyboard shortcuts

Hermes Agent Docs i18n