Atomic Mail Agentic

官方

面向AI代理的电子邮件API——通过MCP发送、接收和管理电子邮件

GitHub
255
试用此 MCP赞助

你可以用 Atomic Mail Agentic MCP 做什么？

  • 注册收件箱 — 让您的助手通过 register 创建一个新的 @atomicmail.ai 地址，选择您偏好的用户名，无需手动设置或验证。
  • 收发邮件 — 使用 jmap_request 读取收件箱、发送消息、创建草稿，并通过完整的 JMAP API 管理会话线程。
  • 运行预设操作 — 通过将文件名传递给 jmap_request 来调用内置预设，如 send_mail、list_inbox 或 reply，而无需编写原始 JMAP JSON。
  • 获取内置指导 — 当您的代理在工作流中遇到困难时，调用 help 获取嵌入式文档、速查表和故障排除提示。
  • 使用自定义域名 — 通过 register --api-key 在您自己的已验证域名上连接收件箱（例如 agent@yourcompany.com），并保持相同的 JMAP 操作和预设功能。

文档

CI success   version 0.3   website atomicmail.ai   dashboard sign in   docs guide   issues open   ClawHub skill   Hermes skill   Dify plugin   MCP registry

Atomic Mail Agentic Logo

Atomic Mail Agentic

为你的智能体提供一个真正的收件箱

仪表盘 · 网站 · 文档 · 问题

账户免费，提供 100 MB 存储配额，包含自定义域名，并为智能体工作负载设计了速率限制。

Atomic Mail Agentic 是一个面向自主 AI 智能体的电子邮件服务提供商，由 Atomic Mail 构建。智能体自行注册自己的 @atomicmail.ai 收件箱并端到端管理它——无需人工设置、验证或持续干预。

该服务基于 JMAP（RFC 8620）构建，因此智能体可以获得完整的邮箱 API：读取和发送邮件、创建草稿、管理会话、搜索等。JMAP 在 LLM 训练数据中具有很好的代表性，因此模型已经能够流利地使用它——它们很少会幻觉化请求结构，这意味着更少的重试和更可靠的自动化。

访问通过一种新颖的**工作量证明（PoW）**注册协议进行门控：无需 CAPTCHA 或人工审批即可获得强大的反滥用特性，因此智能体可以完全无人值守地完成注册和操作。

Atomic Mail 提供了多种标准集成路径——MCP、AgentSkill、REST API 等——这使得它可以高度适用于任何智能体：Claude Code、Codex、GitHub Copilot、Cursor、Hermes、OpenClaw、Pi、Kilo Code 等。无论你的工作流程是什么，你都可以轻松实现收件箱管理的自动化。

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

🚀 快速安装

💬 就绪提示词（适用于任何智能体）

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.

Atomic Mail Agentic Demo

🔌 MCP（stdio）

将此添加到你的 MCP 主机配置中（或者直接让你的智能体来做这件事）：

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

然后重启主机，并让你的智能体创建一个收件箱。

🦞 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 注册即可无人值守地创建。要从你自己的域名（support@yourcompany.com）发送邮件，请在仪表盘中设置一次——这是一个人工控制平面，与智能体流程分离，因为它需要对你自己拥有的域名进行 DNS 更改。

在那里，你可以添加并验证域名（TXT 所有权 + MX 记录；可重复运行，传播通常只需几分钟），并在该域名上创建收件箱——每个收件箱都会获得一个完整的地址（agent@yourcompany.com）和一个来自 Connect 对话框的 API 密钥，发送时使用与域名对齐的 From 进行签名。

客户端不会改变——相同的 jmap_request、预设和 JMAP 结构。自定义域名收件箱是一个登录，而不是 PoW 注册：使用其 API 密钥（atomicmail register --api-key "…"）或 OAuth 连接。$INBOX 解析为真实地址（agent@yourcompany.com），因此自我寻址和 From 无需额外配置即可保持正确。

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

🤖 你的智能体可以做什么

Atomic Mail 旨在通过智能体运行——而不是通过手动收件箱设置。你用自然语言描述工作流程；智能体注册一个 @atomicmail.ai 地址，发送和接收邮件，并保持会话继续进行。你不需要配置脚本、在标签页之间复制 API 密钥或记忆 JMAP。一切都是自动化的。

如果智能体遇到困难，集成设计为自行恢复：help 附带嵌入式文档（预设、cron、故障排除），捆绑的 JSON 预设涵盖常见操作，错误信息包含下一步尝试的提示。

示例工作流程

新闻通讯摘要——“让你的收件箱订阅这些新闻通讯，阅读所有内容，并每天给我发送一封关于 AI 工具重要内容的摘要邮件。” 智能体拥有一个专用收件箱，过滤噪音，只呈现与你兴趣匹配的内容——而不触及你的个人邮箱。

支持收件箱——“监控 support@ 并回复我们文档中的工单；只有在你无法回答时才升级给我。” 智能体读取入站邮件，查询其已知信息，发送完整回复，并处理边缘情况。

用户研究访谈——“运行一项电子邮件调查：发送这些问题，根据回复进行跟进，并总结发现。” 智能体进行异步访谈——受访者按自己的时间表回复，无需预约通话。

📬 精彩的 Atomic Mail

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

✨ 为什么选择 Atomic Mail

  • 智能体无需向用户索取任何东西即可完成：PoW 注册在约 30 秒内提供一个真实的 @atomicmail.ai 收件箱——无需验证域名、无需信用卡、无需 CAPTCHA 流程、无需邮件服务器运维
  • 消息真正送达：持续预热 IP 池并带有中继溢出——当另一端的真人必须阅读你的邮件时，送达率至关重要
  • JMAP——智能体已经知道的 API：标准 RFC 8620/8621，在 LLM 训练数据中；批量方法调用（查询、获取、草稿、发送）在一次往返中完成——无需学习供应商 SDK
  • 在集成内部解决卡顿：错误信息附带通俗易懂的提示；成功响应建议 _next 步骤；help 返回速查表和实际示例——无需网络搜索
  • 自带域名：智能体开箱即用地运行在 @atomicmail.ai 上，或者运行在你通过仪表盘验证的域名上——相同的客户端、相同的 JMAP、域名对齐的 From
  • 无供应商锁定：JMAP 是 IETF 标准；收件箱以后可以移植到任何符合标准的提供商
  • 当原始 JMAP 过于繁琐时使用预设：捆绑的 send_mail、list_inbox、reply 等——将文件名传递给 jmap_request，而不是从头生成方法调用 JSON
  • 处处相同的核心：一个认证、JMAP、预设和帮助栈驱动 MCP 和 AgentSkill；当你运行多个智能体时，每个收件箱有独立的凭据目录

📚 按目标查阅文档

目标从这里开始
首次设置docs/getting-started.md
你自己的域名 + 仪表盘docs/custom-domains.md
MCP 主机docs/mcp.md
Shell / cron 智能体docs/skill-install.md
LangChain 智能体docs/langchain.md
智能体运行手册docs/SKILL.md
原始认证 + JMAPdocs/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 写入
  • 入站邮件是不可信输入；未经确认，不要让智能体执行邮件中的指令
  • 仅从 @atomicmail npm 范围安装

🤝 贡献

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

有关设置、测试命令和 PR 期望，请参阅 CONTRIBUTING.md。

📄 许可证

MIT