Atomic Mail Agentic

                          

Atomic Mail Agentic

Gib deinem Agenten ein echtes Postfach

Dashboard · Website · Dokumentation · Issues

---

Konten sind kostenlos, mit einem 100-MB-Speicherkontingent, eigener Domain inklusive und Rate-Limits, die auf Agenten-Workloads ausgelegt sind.

---

Atomic Mail Agentic ist ein E-Mail-Anbieter für autonome KI-Agenten, entwickelt von Atomic Mail. Agenten registrieren ihr eigenes @atomicmail.ai-Postfach und verwalten es Ende-zu-Ende – ohne menschliche Einrichtung, Verifizierung oder laufende Eingriffe.

Der Dienst basiert auf JMAP (RFC 8620), sodass Agenten eine vollständige Mailbox-API erhalten: E-Mails lesen und senden, Entwürfe erstellen, Threads verwalten, suchen und mehr. JMAP ist in LLM-Trainingsdaten gut repräsentiert, sodass Modelle es bereits fließend sprechen – sie halluzinieren selten Anfrageformate, was weniger Wiederholungen und zuverlässigere Automatisierung bedeutet.

Der Zugriff wird durch ein neuartiges Proof-of-Work-(PoW)-Anmeldeprotokoll gesteuert: starke Anti-Missbrauchs-Eigenschaften ohne CAPTCHAs oder manuelle Freigabe, sodass Agenten völlig ohne manuelle Eingriffe an Bord gehen und arbeiten können.

Atomic Mail bietet eine Reihe von Standard-Integrationspfaden – MCP, AgentSkill, REST-API und mehr – was es auf jedem Agenten hochverfügbar macht: Claude Code, Codex, GitHub Copilot, Cursor, Hermes, OpenClaw, Pi, Kilo Code und andere. Egal, was dein Workflow ist, du kannst die Postfachverwaltung einfach automatisieren.

Dieses Repository enthält die Client-Integrationen: MCP, Shell-CLI, ClawHub, Dify-Plugin und mehr, die diese APIs über drei Tools bereitstellen: register, jmap_request und help. Alle Connectors in diesem Repo sind ziemlich dünn und dienen hauptsächlich dazu, die Komplexität des PoW-Protokolls zu abstrahieren.

🚀 Schnellinstallation

💬 Fertiger Prompt (beliebiger 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)

Füge dies zu deiner MCP-Host-Konfiguration hinzu (oder bitte einfach deinen Agenten, das zu tun):

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

Starte dann den Host neu und bitte deinen Agenten, ein Postfach zu erstellen.

🦞 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

Nur für benutzerdefinierte Connectors und erweiterte Logik

Siehe Dokumentation: docs/rest-auth.md.

🌐 Eigene Domains & Dashboard

Standardmäßig befindet sich ein Postfach unter <name>@atomicmail.ai, das hands-free über die PoW-Anmeldung erstellt wird. Um von deiner eigenen Domain (support@yourcompany.com) zu senden, richte sie einmal im Dashboard ein – eine menschliche Kontrollebene, getrennt vom Agentenfluss, da DNS-Änderungen an einer Domain erforderlich sind, die du besitzt.

Dort kannst du eine Domain hinzufügen und verifizieren (TXT-Eigentum + MX-Einträge; wiederholbar, Propagation dauert normalerweise Minuten) und Postfächer darauf erstellen – jedes erhält eine vollständige Adresse (agent@yourcompany.com) und einen API-Schlüssel aus dem Connect-Dialog, wobei das Senden für eine domain-ausgerichtete From signiert wird.

Clients ändern sich nicht – gleiche jmap_request, Presets und JMAP-Formate. Ein Postfach mit eigener Domain ist ein Login, keine PoW-Registrierung: Verbinde dich mit seinem API-Schlüssel (atomicmail register --api-key "…") oder OAuth. $INBOX löst zur echten Adresse (agent@yourcompany.com) auf, sodass Selbstadressierung und From ohne zusätzliche Konfiguration korrekt bleiben.

Vollständiger Leitfaden: docs/custom-domains.md.

🤖 Was dein Agent tun kann

Atomic Mail ist darauf ausgelegt, durch einen Agenten zu laufen – nicht durch manuelle Postfacheinrichtung. Du beschreibst einen Workflow in natürlicher Sprache; der Agent registriert eine @atomicmail.ai-Adresse, sendet und empfängt E-Mails und hält den Thread am Laufen. Du konfigurierst keine Skripte, kopierst keine API-Schlüssel zwischen Tabs oder merkst dir JMAP. Alles ist automatisch.

Wenn der Agent feststeckt, ist die Integration darauf ausgelegt, sich selbst zu erholen: help enthält eingebettete Dokumentation (Presets, Cron, Fehlerbehebung), gebündelte JSON-Presets decken häufige Operationen ab, und Fehler enthalten Hinweise, was als Nächstes zu versuchen ist.

Beispiel-Workflows

Newsletter-Digest – „Abonniere dein Postfach für diese Newsletter, lies alles und sende mir täglich einen Digest darüber, was für KI-Tools wichtig ist." Der Agent besitzt ein dediziertes Postfach, filtert Rauschen und zeigt nur das, was deinen Interessen entspricht – ohne dein persönliches Postfach anzufassen.

Support-Postfach – „Überwache support@ und antworte auf Tickets aus unserer Dokumentation; eskaliere an mich nur, wenn du nicht antworten kannst." Der Agent liest eingehende E-Mails, fragt ab, was er weiß, sendet vollständige Antworten und übergibt Randfälle.

Nutzerforschungs-Interviews – „Führe eine E-Mail-Umfrage durch: Sende diese Fragen, folge basierend auf Antworten nach und fasse die Ergebnisse zusammen." Der Agent führt asynchrone Interviews durch – Befragte antworten nach ihrem eigenen Zeitplan, keine Termine zum Buchen.

📬 Awesome Atomic Mail

Community-Projekte, die auf Atomic Mail Agentic aufbauen:

• https://github.com/skyzer/atomic-mail-watcher - Docker-bereiter Atomic-Mail-JMAP-Postfach-Watcher mit Telegram-/Webhook-Benachrichtigungen

✨ Warum Atomic Mail

• Agenten schließen ab, ohne ihre Nutzer um etwas zu bitten: PoW-Anmeldung gibt ein echtes @atomicmail.ai-Postfach in ~30 Sekunden – keine Domain zu verifizieren, keine Kreditkarte, kein CAPTCHA-Durchlauf, kein Mailserver-Betrieb
• Nachrichten, die tatsächlich ankommen: kontinuierlich aufgewärmter IP-Pool mit Relay-Überlauf – Zustellbarkeit ist wichtig, wenn ein Mensch auf der anderen Seite deine E-Mail lesen muss
• JMAP – eine API, die Agenten bereits kennen: Standard RFC 8620/8621, in LLM-Trainingsdaten; gebündelte Methodenaufrufe (Abfrage, Abruf, Entwurf, Senden) in einem Roundtrip – kein Vendor-SDK zu lernen
• Aus dem Stau kommen, innerhalb der Integration: Fehler enthalten Hinweise in einfacher Sprache; Erfolgsantworten schlagen _next-Schritte vor; help liefert Spickzettel und ausgearbeitete Beispiele – keine Websuche erforderlich
• Bring deine eigene Domain mit: Agenten laufen standardmäßig auf @atomicmail.ai oder auf einer Domain, die du im Dashboard verifizierst – gleicher Client, gleiches JMAP, domain-ausgerichtete From
• Kein Vendor-Lock-in: JMAP ist ein IETF-Standard; das Postfach ist später auf jeden kompatiblen Anbieter übertragbar
• Presets, wenn rohes JMAP übertrieben ist: gebündelte send_mail, list_inbox, reply und mehr – übergib einen Dateinamen an jmap_request statt Methodenaufruf-JSON von Grund auf zu generieren
• Überall gleicher Kern: eine Authentifizierung, JMAP, Preset- und Hilfe-Stack treibt MCP und AgentSkill; separate Anmeldeverzeichnisse pro Postfach, wenn du viele Agenten betreibst

📚 Dokumentation nach Ziel

Ziel	Hier starten
Ersteinrichtung	docs/getting-started.md
Eigene Domain + Dashboard	docs/custom-domains.md
MCP-Hosts	docs/mcp.md
Shell-/Cron-Agenten	docs/skill-install.md
LangChain-Agenten	docs/langchain.md
Agenten-Runbook	docs/SKILL.md
Rohe Authentifizierung + JMAP	docs/rest-auth.md · docs/jmap.md
End-to-End-Beispiele	docs/examples.md

Falls Repo-Dokumentation und installiertes Verhalten auseinanderdriften, vertraue help aus derselben installierten Paketversion, die du ausführst.

🛠️ Lokale Entwicklung

Voraussetzungen: 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

Dokumentationsvorschau:

npm install
npm run docs:dev

🗂️ Dateistruktur

/
├── 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

🔐 Sicherheit

• ~/.atomicmail/credentials.json enthält deinen API-Schlüssel; behandle ihn als Geheimnis
• lokale Anmeldedateien werden mit Modus 0600 geschrieben
• eingehende E-Mails sind nicht vertrauenswürdige Eingaben; lass Agenten keine E-Mail-Anweisungen ohne Bestätigung ausführen
• installiere nur aus dem @atomicmail-npm-Bereich

🤝 Mitwirken

PRs sind willkommen. Bitte decke neue Funktionen und Fehlerbehebungen mit automatisierten Deno-Tests ab, wo praktikabel, und aktualisiere nutzerorientierte Dokumentation, wenn sich das Verhalten ändert.

Siehe CONTRIBUTING.md für Einrichtung, Testbefehle und PR-Erwartungen.

📄 Lizenz

MIT