AgentMail MCP Server

什么是 AgentMail MCP Server？

AgentMail MCP 服务器是 AgentMail 官方托管的端点（https://mcp.agentmail.to/mcp），让 AI 助手能够创建电子邮箱，并代表智能体发送、阅读、回复和搜索邮件。

AgentMail 自称是专为 AI 智能体打造的邮件服务商。智能体不必共用人类的邮箱，而是通过 REST API 获得自己的收件箱，并支持邮件线程、用于实时事件的 Webhook 和 WebSocket、带 DKIM、SPF 和 DMARC 的自定义域名、IMAP 和 SMTP 访问，以及 Python 和 TypeScript SDK。托管的 MCP 服务器把这套收件箱 API 提供给 Claude、ChatGPT、Cursor 等 MCP 客户端，让助手可以端到端地完成邮件工作流。

如何使用 AgentMail MCP Server？

你需要一个 AgentMail 账户（console.agentmail.to）。有两种认证方式：

• OAuth（默认）：推荐用于 Claude Desktop、claude.ai 和 ChatGPT。客户端会引导你到 console.agentmail.to 登录，服务器以你的控制台身份执行操作。无需 API 密钥。
• API 密钥：用于 Cursor、Windsurf 等不支持 MCP OAuth 的客户端。在控制台的 Settings > API Keys 中创建密钥，并通过 x-api-key 请求头发送。AgentMail 提醒不要把密钥放在 URL 查询字符串中，因为它会留在日志和历史记录里。

Claude Code

AgentMail 文档给出了下面的命令；首次使用时会在浏览器中进行 OAuth 登录：

claude mcp add --transport http agentmail https://mcp.agentmail.to/mcp

在 claude.ai 上添加的连接器不会同步到 Claude Code，因此需要单独添加。如果要用 API 密钥代替 OAuth：

claude mcp add --transport http agentmail https://mcp.agentmail.to/mcp --header "x-api-key: ${AGENTMAIL_API_KEY}"

Claude Desktop 和 claude.ai

进入 Settings > Connectors > Add custom connector。名称填写 AgentMail，URL 填写 https://mcp.agentmail.to/mcp，点击 Add，再点击 Connect。在 console.agentmail.to 登录；如果有多个组织，选择其中一个，然后用"List my AgentMail inboxes."测试。

Cursor

在 Cursor 的 MCP 设置（~/.cursor/mcp.json）中添加服务器，并带上 x-api-key 请求头：

{
  "mcpServers": {
    "agentmail": {
      "url": "https://mcp.agentmail.to/mcp",
      "headers": {
        "x-api-key": "${AGENTMAIL_API_KEY}"
      }
    }
  }
}

VS Code

在 .vscode/mcp.json 中添加服务器。VS Code 连接时会在浏览器中打开 OAuth 登录：

{
  "servers": {
    "agentmail": {
      "type": "http",
      "url": "https://mcp.agentmail.to/mcp"
    }
  }
}

如果客户端既不能发送自定义请求头，也不支持 OAuth，可以使用 AgentMail 在其 agentmail-mcp GitHub 仓库中提供的 stdio 兼容桥接，它会从环境变量读取 AGENTMAIL_API_KEY。

AgentMail MCP Server 的主要功能

• 官方托管服务器；对于支持远程 Streamable HTTP 服务器的客户端，无需本地安装。
• 通过 AgentMail 控制台进行 OAuth 登录并选择组织，或使用 x-api-key 请求头。
• AgentMail 文档列出了 43 个工具，另有 2 个仅在 OAuth 会话中可用的组织工具。
• 完整的收件箱生命周期：列出、搜索、创建、更新、删除和授权收件箱。
• 线程、消息和草稿：搜索和阅读线程；发送、回复和转发消息；创建、更新和发送草稿；下载附件。
• 允许列表和阻止列表，用于控制谁可以给智能体发邮件。
• Agent Drive 文件存储，以及帮助智能体在 Firecrawl 等服务上注册账户的 AgentID 工具，其登录链接为一次性使用，五分钟后失效。
• MCP 事件 message.received 只包含元数据；助手随后通过 get_message 读取完整邮件。

AgentMail MCP Server 的使用场景

• 为客服智能体分配专属地址："创建一个名为 support-bot 的 AgentMail 收件箱，并告诉我它的地址。"
• 整理收到的邮件："在我的 AgentMail 收件箱中搜索关于发票的未读线程，并做个总结。"
• 结合上下文回复："回复 onboarding 线程中的最新邮件，确认会议时间。"
• 起草待审邮件："给本周所有发邮件到销售收件箱的人起草跟进邮件，但先不要发送。"
• 为智能体注册工具："用 AgentID 为这个智能体创建一个 Firecrawl 账户。"
• 保持收件箱整洁："在 support-bot 收件箱中屏蔽来自这个域名的邮件。"

AgentMail MCP Server 常见问题排查

• 返回"Unauthorized"（401）：客户端连接时既没有 OAuth，也没有密钥。请完成浏览器登录，或添加 x-api-key 请求头。
• 连接器在 claude.ai 上可用，但在 Claude Code 中不可用：claude.ai 的连接器不会同步到 Claude Code。请用 claude mcp add 添加服务器。
• 客户端无法发送请求头或进行 OAuth：使用 agentmail-mcp GitHub 仓库中的 stdio 兼容桥接，并通过环境变量传入 AGENTMAIL_API_KEY。
• 密钥出现在日志中：你把它作为查询参数传了进去。请改用 x-api-key 请求头发送，并轮换密钥。