Atomic Mail Agentic

公式

AIエージェント向けのメールAPI – MCP経由でメールの送信、受信、管理が可能

GitHub
255
このMCPを試すスポンサー

Atomic Mail Agentic MCPで何ができますか？

  • 受信トレイを登録 — アシスタントにregisterを使って新しい@atomicmail.aiアドレスを作成してもらいます。希望のユーザー名を選択するだけで、手動設定や確認は不要です。
  • メールの送受信 — jmap_requestを使用して受信トレイの読み取り、メッセージの送信、下書きの作成、スレッドの管理をJMAPI API全体を通じて行います。
  • プリセット操作を実行 — send_mail、list_inbox、replyなどのバンドル済みプリセットを、生のJMAPI JSONを書く代わりにjmap_requestにファイル名を渡して呼び出します。
  • 組み込みガイダンスを取得 — エージェントがワークフローで行き詰まったときに、helpを呼び出して埋め込みドキュメント、チートシート、トラブルシューティングのヒントを取得します。
  • カスタムドメインを使用 — register --api-keyを使用して、検証済みの独自ドメイン（例：agent@yourcompany.com）で受信トレイを接続し、同じJMAPI操作とプリセットを維持します。

ドキュメント

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のトレーニングデータに豊富に含まれているため、モデルはすでに流暢に扱うことができます — リクエスト形式を幻覚することはほとんどなく、リトライが減り、より信頼性の高い自動化が実現します。

アクセスは、新しい 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.

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トレーニングデータに含まれる；バッチメソッド呼び出し（クエリ、フェッチ、下書き、送信）を1回のラウンドトリップで実行 — ベンダーSDKを学ぶ必要はありません
  • 統合内で行き詰まりを解消：エラーには平易な言語のヒントが含まれ、成功レスポンスは _next のステップを提案し、help はチートシートと実例を返します — ウェブ検索は不要
  • 自分のドメインを持ち込む：エージェントはデフォルトで @atomicmail.ai で動作し、ダッシュボード で検証したドメインでも動作します — 同じクライアント、同じJMAP、ドメイン整合の From
  • ベンダーロックインなし：JMAPはIETF標準であり、受信トレイは後で任意の準拠プロバイダーに移行可能
  • 生のJMAPが過剰な場合のプリセット：バンドルされた send_mail、list_inbox、reply など — メソッド呼び出しJSONをゼロから生成する代わりに、jmap_request にファイル名を渡します
  • どこでも同じコア：1つの認証、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
生の認証 + 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