Atomic Mail Agentic

                          

Atomic Mail Agentic

エージェントに本物の受信トレイを

ダッシュボード · ウェブサイト · ドキュメント · イシュー

---

アカウントは無料で、100 MB のストレージ容量、カスタムドメインが含まれており、エージェントのワークロードに適したレート制限が設定されています。

---

Atomic Mail Agentic は、自律型 AI エージェント向けのメールプロバイダーです。Atomic Mail が開発しました。エージェントは自身の @atomicmail.ai 受信トレイを登録し、最初から最後まで管理できます。人間による設定、確認、継続的な介入は不要です。

このサービスは JMAP（RFC 8620）を基盤としているため、エージェントはメールの読み取りや送信、下書きの作成、スレッドの管理、検索などを行える、フル機能のメールボックス API を利用できます。JMAP は LLM の学習データに広く含まれているため、モデルはすでに流暢に扱えます。リクエストの形式を幻覚することはほとんどなく、その結果、再試行が減り、自動化の信頼性が高まります。

アクセスは、新しい proof-of-work（PoW） 登録プロトコルで制御されています。CAPTCHA や手動承認なしで強力な不正利用対策を実現しているため、エージェントは完全に人手を介さずに登録し、操作できます。

Atomic Mail は、MCP、AgentSkill、REST API など、複数の標準的な連携方法を提供しているため、Claude Code、Codex、GitHub Copilot、Cursor、Hermes、OpenClaw、Pi、Kilo Code など、あらゆるエージェントですぐに利用できます。どのようなワークフローでも、受信トレイを簡単に自動管理できます。

このリポジトリには、クライアント連携機能が含まれています。MCP、シェル CLI、ClawHub、Dify プラグインなどを通じて、API を register、jmap_request、help の 3 つのツールとして公開します。このリポジトリ内のコネクターはどれも非常に軽量で、主に 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.

🔌 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 登録を通じて人手を介さずに作成されます。独自のドメイン（[email protected]）から送信するには、ダッシュボードで一度設定します。所有するドメインの 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。

🤖 エージェントでできること

Atomic Mail は手動で受信トレイを設定するのではなく、エージェント経由で動作するように設計されています。ワークフローを自然な言葉で説明すると、エージェントが @atomicmail.ai アドレスを登録し、メールを送受信して、スレッドのやり取りを続けます。スクリプトの設定や、タブ間での API キーのコピー、JMAP の暗記は必要ありません。すべて自動で行われます。

エージェントが行き詰まっても、連携機能が自力で復旧できるように設計されています。help にはドキュメント（プリセット、cron、トラブルシューティング）が組み込まれており、よく使う操作を網羅した JSON プリセットが同梱されています。また、エラーには次に試すことのヒントが含まれています。

ワークフローの例

ニュースレターのダイジェスト — 「この受信トレイをこれらのニュースレターに登録して、すべて読んだうえで、AI ツールに関する重要な情報を毎日ダイジェストにしてメールで送ってください。」 エージェントは専用の受信トレイを管理し、ノイズを除外して、個人用メールボックスには触れずに、関心に合う情報だけを取り出します。

サポート用受信トレイ — 「support@ を監視して、ドキュメントに基づいてチケットに返信してください。回答できない場合だけ、私にエスカレーションしてください。」 エージェントは受信メールを読み、把握している情報を照会し、完全な返信を送信して、対応が難しいケースを引き継ぎます。

ユーザーリサーチのインタビュー — 「メールアンケートを実施してください。これらの質問を送信し、返信に応じてフォローアップして、結果を要約してください。」 エージェントは非同期のインタビューを実施します。回答者は自分の都合に合わせて返信できるため、電話の予約は不要です。

📬 すばらしい Atomic Mail

Atomic Mail Agentic を基盤に構築されたコミュニティプロジェクトです。

• https://github.com/skyzer/atomic-mail-watcher - Telegram／webhook 通知に対応した、Docker 対応の Atomic Mail JMAP 受信トレイ監視ツール

✨ Atomic Mail を選ぶ理由

• ユーザーに何も尋ねずにエージェントがタスクを完了できます：PoW 登録により、約 30 秒で実際に使える @atomicmail.ai 受信トレイを取得できます。ドメインの確認も、クレジットカードも、CAPTCHA の操作も、メールサーバーの運用も不要です
• メールが実際に届きます：IP プールを継続的にウォームアップし、リレーであふれた分を処理します。相手が人間で、その人にメールを読んでもらう必要がある場合、到達性は重要です
• JMAP — エージェントがすでに知っている API：RFC 8620/8621 標準で、LLM のトレーニングデータにも含まれています。メソッド呼び出し（query、fetch、draft、send）をまとめて 1 回のラウンドトリップで実行でき、ベンダーの SDK を習得する必要はありません
• 連携機能内で行き詰まりを解消：エラーには平易な言葉でヒントが示され、成功レスポンスには次の手順として _next が提示されます。help ではチートシートと実例を確認できるため、ウェブ検索は不要です
• 独自のドメインを利用可能：エージェントは標準で @atomicmail.ai を使うほか、ダッシュボードで確認したドメインも使えます。同じクライアント、同じ JMAP を利用し、From もドメインに一致します
• ベンダーロックインなし：JMAP は IETF 標準であり、受信トレイは後から準拠プロバイダーへ移行できます
• 生の JMAP が過剰な場合はプリセットを利用：send_mail、list_inbox、reply などが同梱されています。メソッド呼び出し用の JSON を一から生成する代わりに、jmap_request にファイル名を渡せます
• どこでも同じコア機能：共通の認証、JMAP、プリセット、ヘルプのスタックが MCP と AgentSkill を支えます。多数のエージェントを実行する場合は、受信トレイごとに認証情報ディレクトリを分けられます

📚 目的別ドキュメント

目的	まずはこちらから
初回セットアップ	docs/getting-started.md
独自ドメイン + ダッシュボード	docs/custom-domains.md
MCP ホスト	docs/mcp.md
シェル / cron エージェント	docs/skill-install.md
LangChain エージェント	docs/langchain.md
エージェントの運用手順書	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 で書き込まれます
• 受信メールは信頼できない入力です。確認なしにエージェントにメールの指示を実行させないでください
• @atomicmail npm スコープからのみインストールしてください

🤝 コントリビューション

PR を歓迎します。新機能やバグ修正には、可能な場合は自動化された Deno テストを追加し、動作に変更がある場合はユーザー向けドキュメントも更新してください。

セットアップ、テストコマンド、PR に関する要件については、CONTRIBUTING.md を参照してください。

📄 ライセンス

MIT