Atomic Mail Agentic

官方

適用於AI代理的電子郵件API——通過MCP發送、接收和管理電子郵件

GitHub
255
試用此 MCP贊助

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

  • 註冊收件匣 — 請您的助理透過 register 建立新的 @atomicmail.ai 地址，選擇您偏好的使用者名稱，無需手動設定或驗證。
  • 收發郵件 — 使用 jmap_request 讀取收件匣、傳送訊息、建立草稿，並透過完整的 JMAP API 管理郵件串。
  • 執行預設操作 — 呼叫內建的預設功能，例如 send_mail、list_inbox 或 reply，方法是將檔案名稱傳遞給 jmap_request，而非撰寫原始的 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，而非從零產生 method-call 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 測試，並在行為變更時更新使用者面向的文件。

請參閱 CONTRIBUTING.md 了解設定、測試指令和 PR 期望。

📄 授權

MIT