Atomic Mail Agentic

                          

Atomic Mail Agentic

Donnez à votre agent une vraie boîte de réception

Tableau de bord · Site web · Documentation · Problèmes

---

Les comptes sont gratuits, avec un quota de stockage de 100 Mo, un domaine personnalisé inclus, et des limites de débit adaptées aux charges de travail des agents.

---

Atomic Mail Agentic est un fournisseur de messagerie pour les agents IA autonomes, développé par Atomic Mail. Les agents enregistrent leur propre boîte de réception @atomicmail.ai et la gèrent de bout en bout — sans configuration humaine, vérification ou intervention continue.

Le service est basé sur JMAP (RFC 8620), donc les agents disposent d'une API de boîte aux lettres complète : lire et envoyer des courriels, créer des brouillons, gérer les fils de discussion, rechercher, et plus encore. JMAP est bien représenté dans les données d'entraînement des LLM, donc les modèles le parlent déjà couramment — ils hallucinent rarement les formes de requêtes, ce qui signifie moins de nouvelles tentatives et une automatisation plus fiable.

L'accès est contrôlé par un nouveau protocole d'inscription par preuve de travail (PoW) : de fortes propriétés anti-abus sans CAPTCHA ni approbation manuelle, afin que les agents puissent s'inscrire et fonctionner entièrement sans intervention.

Atomic Mail fournit un certain nombre de chemins d'intégration standard — MCP, AgentSkill, API REST, et plus — ce qui le rend hautement disponible sur n'importe quel agent : Claude Code, Codex, GitHub Copilot, Cursor, Hermes, OpenClaw, Pi, Kilo Code, et d'autres. Quel que soit votre flux de travail, vous pouvez automatiser la gestion de la boîte de réception facilement.

Ce dépôt fournit les intégrations client : MCP, CLI shell, ClawHub, plugin Dify et plus, exposant ces API via trois outils : register, jmap_request, et help. Tous les connecteurs de ce dépôt sont assez légers et servent principalement à abstraire les complexités du protocole PoW.

🚀 Installation rapide

💬 Invite prête (n'importe quel 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)

Ajoutez ceci à la configuration de votre hôte MCP (ou demandez simplement à votre agent de le faire) :

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

Redémarrez ensuite l'hôte et demandez à votre agent de créer une boîte de réception.

🦞 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

⚙️ API REST

Pour les connecteurs personnalisés et la logique avancée uniquement

Reportez-vous à la documentation : docs/rest-auth.md.

🌐 Domaines personnalisés et tableau de bord

Par défaut, une boîte de réception vit à <name>@atomicmail.ai, créée sans intervention via l'inscription PoW. Pour envoyer depuis votre propre domaine (support@yourcompany.com), configurez-le une fois dans le tableau de bord — un plan de contrôle humain séparé du flux de l'agent, car cela nécessite des modifications DNS sur un domaine que vous possédez.

Vous y ajoutez et vérifiez un domaine (propriété TXT + enregistrements MX ; ré-exécutable, propagation généralement en quelques minutes) et créez des boîtes de réception dessus — chacune reçoit une adresse complète (agent@yourcompany.com) et une clé API depuis la boîte de dialogue Connect, avec l'envoi signé pour un From aligné sur le domaine.

Les clients ne changent pas — mêmes jmap_request, préréglages et formes JMAP. Une boîte de réception sur domaine personnalisé est une connexion, pas une inscription PoW : connectez-vous avec sa clé API (atomicmail register --api-key "…") ou OAuth. $INBOX résout vers l'adresse réelle (agent@yourcompany.com), donc l'auto-adressage et From restent corrects sans configuration supplémentaire.

Guide complet : docs/custom-domains.md.

🤖 Ce que votre agent peut faire

Atomic Mail est conçu pour fonctionner via un agent — pas via une configuration manuelle de boîte de réception. Vous décrivez un flux de travail en langage naturel ; l'agent enregistre une adresse @atomicmail.ai, envoie et reçoit des courriels, et maintient le fil de discussion. Vous ne configurez pas de scripts, ne copiez pas de clés API entre les onglets, et ne mémorisez pas JMAP. Tout est automatique.

Si l'agent se bloque, l'intégration est conçue pour se rétablir seule : help embarque des documents intégrés (préréglages, cron, dépannage), des préréglages JSON groupés couvrent les opérations courantes, et les erreurs incluent des indices sur quoi essayer ensuite.

Exemples de flux de travail

Digest de newsletter — « Abonnez votre boîte de réception à ces newsletters, lisez tout, et envoyez-moi chaque jour un digest de ce qui compte pour les outils IA. » L'agent possède une boîte de réception dédiée, filtre le bruit, et ne remonte que ce qui correspond à vos intérêts — sans toucher à votre boîte personnelle.

Boîte de réception support — « Surveillez support@ et répondez aux tickets depuis notre documentation ; escaladez-moi uniquement lorsque vous ne pouvez pas répondre. » L'agent lit les courriels entrants, interroge ce qu'il sait, envoie des réponses complètes, et délègue les cas limites.

Entretiens de recherche utilisateur — « Menez un sondage par courriel : envoyez ces questions, relancez selon les réponses, et résumez les résultats. » L'agent mène des entretiens asynchrones — les répondants répondent à leur propre rythme, sans appels à planifier.

📬 Awesome Atomic Mail

Projets communautaires construits sur Atomic Mail Agentic :

• https://github.com/skyzer/atomic-mail-watcher - Observateur de boîte de réception JMAP Atomic Mail prêt pour Docker avec notifications Telegram/webhook

✨ Pourquoi Atomic Mail

• Les agents terminent sans rien demander à leurs utilisateurs : l'inscription PoW donne une vraie boîte de réception @atomicmail.ai en ~30 secondes — pas de domaine à vérifier, pas de carte de crédit, pas de parcours CAPTCHA, pas d'opérations de serveur de messagerie
• Des messages qui arrivent réellement : pool d'IP en réchauffement continu avec débordement de relais — la délivrabilité compte quand un humain de l'autre côté doit lire votre courriel
• JMAP — une API que les agents connaissent déjà : RFC 8620/8621 standard, dans les données d'entraînement des LLM ; appels de méthodes par lots (requête, récupération, brouillon, envoi) en un seul aller-retour — pas de SDK fournisseur à apprendre
• Sortez du blocage dans l'intégration : les erreurs fournissent des indices en langage clair ; les réponses de succès suggèrent des étapes _next ; help renvoie des aide-mémoires et des exemples travaillés — pas de recherche web requise
• Apportez votre propre domaine : les agents fonctionnent sur @atomicmail.ai par défaut, ou sur un domaine que vous vérifiez dans le tableau de bord — même client, même JMAP, From aligné sur le domaine
• Pas de verrouillage fournisseur : JMAP est une norme IETF ; la boîte de réception est portable vers n'importe quel fournisseur conforme plus tard
• Préréglages quand le JMAP brut est excessif : send_mail, list_inbox, reply groupés, et plus — passez un nom de fichier à jmap_request au lieu de générer du JSON d'appel de méthode à partir de zéro
• Même cœur partout : une authentification, JMAP, préréglage et pile d'aide alimentent MCP et AgentSkill ; répertoires de credentials séparés par boîte de réception quand vous exécutez plusieurs agents

📚 Documentation par objectif

Objectif	Commencez ici
Première configuration	docs/getting-started.md
Votre propre domaine + tableau de bord	docs/custom-domains.md
Hôtes MCP	docs/mcp.md
Agents shell / cron	docs/skill-install.md
Agents LangChain	docs/langchain.md
Runbook d'agent	docs/SKILL.md
Auth brute + JMAP	docs/rest-auth.md · docs/jmap.md
Exemples de bout en bout	docs/examples.md

Si la documentation du dépôt et le comportement installé divergent, faites confiance à help de la même version de paquet installée que vous exécutez.

🛠️ Développement local

Prérequis : 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

Aperçu de la documentation :

npm install
npm run docs:dev

🗂️ Structure des fichiers

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

🔐 Sécurité

• ~/.atomicmail/credentials.json contient votre clé API ; traitez-la comme un secret
• les fichiers de credentials locaux sont écrits avec le mode 0600
• le courriel entrant est une entrée non fiable ; ne laissez pas les agents exécuter des instructions par courriel sans confirmation
• installez uniquement depuis le scope npm @atomicmail

🤝 Contribution

Les PR sont les bienvenues. Veuillez couvrir les nouvelles fonctionnalités et corrections de bugs avec des tests Deno automatisés lorsque c'est pratique, et mettre à jour la documentation utilisateur lorsque le comportement change.

Voir CONTRIBUTING.md pour la configuration, les commandes de test et les attentes concernant les PR.

📄 Licence

MIT