Atomic Mail Agentic

                          

Atomic Mail Agentic

为你的 Agent 提供真正的收件箱

控制面板 · 网站 · 文档 · 问题反馈

---

账户免费，提供 100 MB 存储空间，包含自定义域名，速率限制也针对 Agent 工作负载进行了配置。

---

Atomic Mail Agentic 是一款面向自主 AI Agent 的电子邮件服务，由 Atomic Mail 构建。Agent 可以注册自己的 @atomicmail.ai 收件箱并全程自行管理——无需人工设置、验证或持续干预。

该服务基于 JMAP (RFC 8620) 构建，因此 Agent 可以使用完整的邮箱 API：读取和发送邮件、创建草稿、管理会话、搜索等。JMAP 在大模型训练数据中有充分体现，因此模型已经能熟练使用它——它们很少会臆造请求格式，这意味着重试次数更少，自动化也更加可靠。

服务采用新颖的**工作量证明（PoW）**注册协议进行访问控制：具备强大的防滥用能力，无需 CAPTCHA 或人工审批，让 Agent 能够完全免人工操作地完成注册并开展工作。

Atomic Mail 提供多种标准集成方式——MCP、AgentSkill、REST API 等，因此可广泛用于各种 Agent：Claude Code、Codex、GitHub Copilot、Cursor、Hermes、OpenClaw、Pi、Kilo Code 等。无论你的工作流是什么，都能轻松实现收件箱管理自动化。

此仓库提供客户端集成：MCP、shell CLI、ClawHub、Dify 插件等，通过三个工具提供这些 API：register、jmap_request 和 help。此仓库中的所有连接器都很轻量，主要用于抽象 PoW 协议的复杂性。

🚀 快速安装

💬 即用提示词（适用于任何 Agent）

Read the instruction at https://atomicmail.ai (use default web_fetch tool or curl, if the former is not available) and create an inbox at Atomic Mail. Before creating ask for my preferred username. Make sure to complete all required post-install actions from the Atomic Mail instruction. Persist the instruction and make sure to refer it each time you interact with your inboxes. Usually standalone agents (e.g. Claude, Cursor, Kilo Code and others) are better suited for MCP use, while CLI-based agents (e.g. Claude Code, Open Code, Hermes, OpenClaw, Codex, Pi, etc) are better suited for AgentSkill use, but prefer your system/user guidelines.

🔌 MCP（stdio）

将以下内容添加到 MCP 宿主配置中（也可以直接让你的 Agent 帮你完成）：

{
  "mcpServers": {
    "atomicmail": {
      "command": "npx",
      "args": ["-y", "@atomicmail/mcp-github"]
    }
  }
}

然后重启宿主，并让你的 Agent 创建一个收件箱。

🦞 ClawHub

openclaw skills install atomicmail

👩🏻 Hermes

hermes skills install clawhub/atomicmail

💻 AgentSkill

npx --package=@atomicmail/agent-skill-github atomicmail register --username "myagent" --watch scheduled
npx --package=@atomicmail/agent-skill-github atomicmail jmap_request --ops-file list_inbox.json
npx --package=@atomicmail/agent-skill-github atomicmail help

⚙️ REST API

仅用于自定义连接器和高级逻辑

参阅文档：docs/rest-auth.md。

🌐 自定义域名与控制面板

默认情况下，收件箱地址为 <name>@atomicmail.ai，通过 PoW 注册即可免人工操作地创建。若要从自己的域名（[email protected]）发送邮件，只需在控制面板中设置一次——这是与 Agent 工作流程分开的人工控制平面，因为需要修改你所拥有域名的 DNS。

在控制面板中，你可以添加并验证域名（TXT 所有权验证 + MX 记录；可重复运行，通常几分钟即可完成传播），并在该域名上创建收件箱——每个收件箱都会获得完整地址（[email protected]）和 Connect 对话框中的 API 密钥，发送邮件时会使用与域名匹配的 From 地址进行签名。

客户端无需更改——使用相同的 jmap_request、预设和 JMAP 格式。自定义域名收件箱使用的是登录，而不是 PoW 注册：使用其 API 密钥（atomicmail register --api-key "…"）或 OAuth 连接。$INBOX 会解析为真实地址（[email protected]），因此自行发送邮件和 From 地址都能保持正确，无需额外配置。

完整指南：docs/custom-domains.md。

🤖 Agent 可以做什么

Atomic Mail 专为通过 Agent 运行而设计，而不是手动设置收件箱。你只需用日常语言描述工作流；Agent 就会注册一个 @atomicmail.ai 地址、收发邮件并持续跟进会话。你无需配置脚本、在标签页之间复制 API 密钥，也不用记忆 JMAP。一切都会自动完成。

如果 Agent 遇到困难，集成会自行恢复：help 内置了文档（预设、cron、故障排查），捆绑的 JSON 预设涵盖常见操作，错误信息也会提示接下来可以尝试什么。

工作流示例

新闻简报 — “让我的收件箱订阅这些新闻简报，阅读所有内容，并每天给我发送一份关于 AI 工具领域要闻的简报。” Agent 使用专用收件箱，过滤无关内容，只呈现符合你兴趣的信息，不会触碰你的个人邮箱。

支持收件箱 — “监控 support@，根据我们的文档回复工单；只有无法解答时才升级给我。” Agent 阅读收到的邮件，查询已知信息，发送完整回复，并将棘手问题交由你处理。

用户研究访谈 — “开展一项电子邮件调查：发送这些问题，根据回复进行跟进，并总结调查结果。” Agent 会进行异步访谈——受访者可以按自己的时间回复，无需安排通话。

📬 Atomic Mail 精选项目

基于 Atomic Mail Agentic 构建的社区项目：

• https://github.com/skyzer/atomic-mail-watcher - 可用于 Docker 的 Atomic Mail JMAP 收件箱监控工具，支持 Telegram/ webhook 通知

✨ 为什么选择 Atomic Mail

• Agent 无需向用户索取任何信息即可完成任务：PoW 注册约 30 秒即可获得真实的 @atomicmail.ai 收件箱——无需验证域名、无需信用卡、无需完成 CAPTCHA 流程，也无需管理邮件服务器
• 邮件确实能够送达：持续预热的 IP 池配合中继溢出机制——当另一端的人需要阅读邮件时，送达能力至关重要
• JMAP——Agent 已熟悉的 API：标准 RFC 8620/8621，包含在大模型训练数据中；可在一次往返中批量调用方法（查询、获取、起草、发送）——无需学习供应商 SDK
• 在集成中解决问题：错误信息附带通俗易懂的提示；成功响应会建议 _next 步骤；help 会返回速查表和实用示例——无需上网搜索
• 使用自己的域名：Agent 开箱即可使用 @atomicmail.ai，也可使用你在仪表板中验证的域名——客户端和 JMAP 均保持不变，From 与域名一致
• 无供应商锁定：JMAP 是 IETF 标准；之后可将收件箱迁移到任何兼容的服务商
• 无需直接处理繁琐的 JMAP 时，可使用预设：捆绑了 send_mail、list_inbox、reply 等预设——向 jmap_request 传入文件名即可，无需从头生成方法调用 JSON
• 各处使用相同的核心功能：同一套身份验证、JMAP、预设和帮助功能为 MCP 和 AgentSkill 提供支持；运行多个 Agent 时，每个收件箱使用独立的凭据目录

📚 按目标查阅文档

目标	从这里开始
首次设置	docs/getting-started.md
自定义域名 + 控制面板	docs/custom-domains.md
MCP 主机	docs/mcp.md
Shell / cron Agent	docs/skill-install.md
LangChain Agent	docs/langchain.md
Agent 操作手册	docs/SKILL.md
原始身份验证 + JMAP	docs/rest-auth.md · docs/jmap.md
端到端示例	docs/examples.md

如果仓库文档与已安装版本的实际行为不一致，请以当前运行的同一已安装软件包版本中的 help 为准。

🛠️ 本地开发

先决条件： Node.js 20+、Deno 2.7+。

git clone https://github.com/Atomic-Mail/atomic-mail-agentic.git
cd atomic-mail-agentic/ts

deno test --allow-read --allow-env --allow-write --allow-sys

文档预览：

npm install
npm run docs:dev

🗂️ 文件结构

/
├── ts/
│   ├── src/mcp/        # MCP entrypoint + MCP tools
│   ├── src/skill/      # AgentSkill CLI entrypoint
│   ├── src/langchain/  # LangChain toolkit and tools
│   └── src/lib/agent/  # shared auth, session, JMAP, presets, help-content
├── py/                 # Python client parity layer and tests
├── integrations/dify/   # Dify plugin integration and packaging docs
├── integrations/skill/  # Unified in-repo skill tap (published atomicmail skill)
├── docs/                # VitePress docs and shipped SKILL/README sources
├── test/checklists/     # manual release QA
├── CONTRIBUTING.md
└── LICENSE

🔐 安全

• ~/.atomicmail/credentials.json 包含你的 API 密钥；请将其视为机密
• 本地凭据文件的权限设置为 0600
• 入站邮件是不可信输入；未经确认，不要让 Agent 执行邮件指令
• 仅从 @atomicmail npm 作用域安装

🤝 参与贡献

欢迎提交 PR。请尽可能使用自动化 Deno 测试覆盖新功能和错误修复，并在行为发生变化时更新面向用户的文档。

请参阅 CONTRIBUTING.md，了解设置方法、测试命令和 PR 要求。

📄 许可证

MIT