Atomic Mail Agentic

                          

Atomic Mail Agentic

Dale a tu agente una bandeja de entrada real

Dashboard · Website · Docs · Issues

---

Las cuentas son gratuitas, con una cuota de almacenamiento de 100 MB, dominio personalizado incluido y límites de tasa ajustados para cargas de trabajo de agentes.

---

Atomic Mail Agentic es un proveedor de correo electrónico para agentes de IA autónomos, creado por Atomic Mail. Los agentes registran su propia bandeja de entrada @atomicmail.ai y la gestionan de extremo a extremo, sin configuración humana, verificación ni intervención continua.

El servicio se basa en JMAP (RFC 8620), por lo que los agentes obtienen una API de buzón completa: leer y enviar correo, crear borradores, gestionar hilos, buscar y más. JMAP está bien representado en los datos de entrenamiento de LLM, por lo que los modelos ya lo hablan con fluidez; rara vez alucinan las formas de las solicitudes, lo que significa menos reintentos y automatización más confiable.

El acceso está controlado por un novedoso protocolo de registro de prueba de trabajo (PoW): fuertes propiedades antiabuso sin CAPTCHAs ni aprobación manual, para que los agentes puedan incorporarse y operar completamente sin intervención.

Atomic Mail proporciona varias rutas de integración estándar — MCP, AgentSkill, API REST y más — lo que lo hace altamente disponible en cualquier agente: Claude Code, Codex, GitHub Copilot, Cursor, Hermes, OpenClaw, Pi, Kilo Code y otros. Sea cual sea tu flujo de trabajo, puedes automatizar la gestión de la bandeja de entrada fácilmente.

Este repositorio incluye las integraciones de cliente: MCP, CLI de shell, ClawHub, plugin de Dify y más, exponiendo esas API a través de tres herramientas: register, jmap_request y help. Todos los conectores en este repositorio son bastante delgados y se necesitan principalmente para abstraer las complejidades del protocolo PoW.

🚀 Instalación rápida

💬 Prompt listo (cualquier agente)

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)

Añade esto a la configuración de tu host MCP (o simplemente pídele a tu agente que lo haga):

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

Luego reinicia el host y pídele a tu agente que cree una bandeja de entrada.

🦞 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

Solo para conectores personalizados y lógica avanzada

Consulta la documentación: docs/rest-auth.md.

🌐 Dominios personalizados y Dashboard

Por defecto, una bandeja de entrada vive en <name>@atomicmail.ai, creada sin intervención mediante el registro PoW. Para enviar desde tu propio dominio (support@yourcompany.com), configúralo una vez en el dashboard — un plano de control humano separado del flujo del agente, ya que requiere cambios de DNS en un dominio que posees.

Allí añades y verificas un dominio (propiedad de TXT + registros MX; re-ejecutable, propagación generalmente en minutos) y creas bandejas de entrada en él — cada una obtiene una dirección completa (agent@yourcompany.com) y una clave API del diálogo Connect, con el envío firmado para un From alineado con el dominio.

Los clientes no cambian — mismos jmap_request, presets y formas JMAP. Una bandeja de entrada de dominio personalizado es un inicio de sesión, no un registro PoW: conéctate con su clave API (atomicmail register --api-key "…") u OAuth. $INBOX se resuelve a la dirección real (agent@yourcompany.com), por lo que el auto-direccionamiento y From se mantienen correctos sin configuración adicional.

Guía completa: docs/custom-domains.md.

🤖 Lo que tu agente puede hacer

Atomic Mail está diseñado para funcionar a través de un agente, no mediante configuración manual de la bandeja de entrada. Describes un flujo de trabajo en lenguaje natural; el agente registra una dirección @atomicmail.ai, envía y recibe correo, y mantiene el hilo en marcha. No configuras scripts, copias claves API entre pestañas ni memorizas JMAP. Todo es automágico.

Si el agente se atasca, la integración está diseñada para recuperarse por sí sola: help incluye documentación integrada (presets, cron, solución de problemas), los presets JSON incluidos cubren operaciones comunes, y los errores incluyen sugerencias sobre qué intentar a continuación.

Flujos de trabajo de ejemplo

Resumen de boletines — "Suscríbete tu bandeja de entrada a estos boletines, lee todo y envíame un resumen diario de lo que importa para las herramientas de IA." El agente posee una bandeja de entrada dedicada, filtra el ruido y muestra solo lo que coincide con tus intereses, sin tocar tu buzón personal.

Bandeja de entrada de soporte — "Monitorea support@ y responde a los tickets de nuestra documentación; escálame solo cuando no puedas responder." El agente lee el correo entrante, consulta lo que sabe, envía respuestas completas y transfiere los casos límite.

Entrevistas de investigación de usuarios — "Realiza una encuesta por correo: envía estas preguntas, haz seguimiento según las respuestas y resume los hallazgos." El agente realiza entrevistas asíncronas — los encuestados responden en su propio horario, sin llamadas que reservar.

📬 Awesome Atomic Mail

Proyectos de la comunidad construidos sobre Atomic Mail Agentic:

• https://github.com/skyzer/atomic-mail-watcher - Vigilante de bandeja de entrada JMAP de Atomic Mail listo para Docker con notificaciones de Telegram/webhook

✨ Por qué Atomic Mail

• Los agentes terminan sin pedir nada a sus usuarios: el registro PoW da una bandeja de entrada real @atomicmail.ai en ~30 segundos — sin dominio que verificar, sin tarjeta de crédito, sin tutorial CAPTCHA, sin operaciones de servidor de correo
• Mensajes que realmente llegan: pool de IPs en calentamiento continuo con desbordamiento de relay — la entregabilidad importa cuando un humano al otro lado debe leer tu correo
• JMAP — una API que los agentes ya conocen: estándar RFC 8620/8621, en datos de entrenamiento de LLM; llamadas de método por lotes (query, fetch, draft, send) en un solo viaje de ida y vuelta — sin SDK de proveedor que aprender
• Desatascarte dentro de la integración: los errores incluyen sugerencias en lenguaje sencillo; las respuestas exitosas sugieren pasos _next; help devuelve hojas de referencia y ejemplos prácticos — sin búsqueda web
• Trae tu propio dominio: los agentes funcionan en @atomicmail.ai de serie, o en un dominio que verifiques en el dashboard — mismo cliente, mismo JMAP, From alineado con el dominio
• Sin bloqueo de proveedor: JMAP es un estándar IETF; la bandeja de entrada es portable a cualquier proveedor compatible más adelante
• Presets cuando JMAP crudo es excesivo: send_mail, list_inbox, reply incluidos y más — pasa un nombre de archivo a jmap_request en lugar de generar JSON de llamadas de método desde cero
• Mismo núcleo en todas partes: una autenticación, JMAP, preset y pila de ayuda alimenta MCP y AgentSkill; directorios de credenciales separados por bandeja de entrada cuando ejecutas muchos agentes

📚 Documentación por objetivo

Objetivo	Empieza aquí
Configuración inicial	docs/getting-started.md
Tu propio dominio + dashboard	docs/custom-domains.md
Hosts MCP	docs/mcp.md
Agentes de shell / cron	docs/skill-install.md
Agentes LangChain	docs/langchain.md
Runbook de agente	docs/SKILL.md
Auth crudo + JMAP	docs/rest-auth.md · docs/jmap.md
Ejemplos de extremo a extremo	docs/examples.md

Si la documentación del repositorio y el comportamiento instalado alguna vez divergen, confía en help de la misma versión del paquete instalado que estás ejecutando.

🛠️ Desarrollo local

Requisitos previos: 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

Vista previa de documentación:

npm install
npm run docs:dev

🗂️ Estructura de archivos

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

🔐 Seguridad

• ~/.atomicmail/credentials.json contiene tu clave API; trátala como un secreto
• los archivos de credenciales locales se escriben con modo 0600
• el correo entrante es entrada no confiable; no dejes que los agentes ejecuten instrucciones de correo sin confirmación
• instala solo desde el ámbito npm @atomicmail

🤝 Contribuciones

Las PRs son bienvenidas. Por favor, cubre nuevas funciones y correcciones de errores con pruebas automatizadas de Deno cuando sea práctico, y actualiza la documentación orientada al usuario cuando cambie el comportamiento.

Consulta CONTRIBUTING.md para configuración, comandos de prueba y expectativas de PR.

📄 Licencia

MIT