Atomic Mail Agentic

                          

Atomic Mail Agentic

Dê ao seu agente uma caixa de entrada real

Dashboard · Website · Docs · Issues

---

As contas são gratuitas, com cota de armazenamento de 100 MB, domínio personalizado incluído e limites de taxa dimensionados para cargas de trabalho de agentes.

---

Atomic Mail Agentic é um provedor de e-mail para agentes de IA autônomos, criado pela Atomic Mail. Os agentes registram sua própria caixa de entrada @atomicmail.ai e a gerenciam de ponta a ponta — sem configuração humana, verificação ou intervenção contínua.

O serviço é construído sobre JMAP (RFC 8620), então os agentes obtêm uma API completa de caixa de entrada: ler e enviar e-mails, criar rascunhos, gerenciar conversas, pesquisar e muito mais. O JMAP está bem representado nos dados de treinamento de LLMs, então os modelos já o falam fluentemente — raramente alucinam formatos de requisição, o que significa menos tentativas e automação mais confiável.

O acesso é controlado por um novo protocolo de cadastro baseado em prova de trabalho (PoW): fortes propriedades anti-abuso sem CAPTCHAs ou aprovação manual, para que os agentes possam se integrar e operar completamente sem intervenção humana.

A Atomic Mail oferece vários caminhos de integração padrão — MCP, AgentSkill, REST API e mais — o que a torna altamente disponível em qualquer agente: Claude Code, Codex, GitHub Copilot, Cursor, Hermes, OpenClaw, Pi, Kilo Code e outros. Seja qual for seu fluxo de trabalho, você pode automatizar o gerenciamento da caixa de entrada facilmente.

Este repositório fornece as integrações de cliente: MCP, CLI de shell, ClawHub, plugin Dify e mais, expondo essas APIs por meio de três ferramentas: register, jmap_request e help. Todos os conectores neste repositório são bastante leves e servem principalmente para abstrair as complexidades do protocolo PoW.

🚀 Instalação Rápida

💬 Prompt Pronto (qualquer 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)

Adicione isto à configuração do seu host MCP (ou apenas peça ao seu agente para fazer isso):

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

Em seguida, reinicie o host e peça ao seu agente para criar uma caixa 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

⚙️ REST API

Para conectores personalizados e lógica avançada apenas

Consulte a documentação: docs/rest-auth.md.

🌐 Domínios Personalizados e Dashboard

Por padrão, uma caixa de entrada fica em <name>@atomicmail.ai, criada sem intervenção humana por meio do cadastro PoW. Para enviar do seu próprio domínio (support@yourcompany.com), configure uma vez no dashboard — um plano de controle humano separado do fluxo do agente, pois requer alterações de DNS em um domínio que você possui.

Lá você adiciona e verifica um domínio (propriedade TXT + registros MX; reexecutável, propagação geralmente em minutos) e cria caixas de entrada nele — cada uma recebe um endereço completo (agent@yourcompany.com) e uma chave de API do diálogo Connect, com envio assinado para um From alinhado ao domínio.

Os clientes não mudam — mesmos jmap_request, predefinições e formatos JMAP. Uma caixa de entrada com domínio personalizado é um login, não um registro PoW: conecte-se com sua chave de API (atomicmail register --api-key "…") ou OAuth. $INBOX resolve para o endereço real (agent@yourcompany.com), então o auto-endereçamento e From permanecem corretos sem configuração extra.

Guia completo: docs/custom-domains.md.

🤖 O Que Seu Agente Pode Fazer

A Atomic Mail foi projetada para operar por meio de um agente — não por configuração manual de caixa de entrada. Você descreve um fluxo de trabalho em linguagem natural; o agente registra um endereço @atomicmail.ai, envia e recebe e-mails e mantém a conversa em andamento. Você não configura scripts, copia chaves de API entre abas ou memoriza JMAP. Tudo é automágico.

Se o agente travar, a integração foi construída para se recuperar sozinha: help inclui documentação embutida (predefinições, cron, solução de problemas), predefinições JSON agrupadas cobrem operações comuns, e erros incluem dicas sobre o que tentar em seguida.

Exemplos de fluxos de trabalho

Resumo de newsletter — "Inscreva sua caixa de entrada nessas newsletters, leia tudo e envie-me um resumo diário do que importa para ferramentas de IA." O agente possui uma caixa de entrada dedicada, filtra ruído e mostra apenas o que corresponde aos seus interesses — sem tocar na sua caixa de entrada pessoal.

Caixa de entrada de suporte — "Monitore support@ e responda aos tickets da nossa documentação; escale para mim apenas quando você não puder responder." O agente lê e-mails recebidos, consulta o que sabe, envia respostas completas e repassa casos de exceção.

Entrevistas de pesquisa com usuários — "Conduza uma pesquisa por e-mail: envie estas perguntas, faça acompanhamento com base nas respostas e resuma os resultados." O agente conduz entrevistas assíncronas — os respondentes respondem no próprio ritmo, sem chamadas para agendar.

📬 Awesome Atomic Mail

Projetos da comunidade construídos sobre Atomic Mail Agentic:

• https://github.com/skyzer/atomic-mail-watcher - Observador de caixa de entrada JMAP Atomic Mail pronto para Docker com notificações via Telegram/webhook

✨ Por que Atomic Mail

• Agentes concluem sem pedir nada aos usuários: o cadastro PoW fornece uma caixa de entrada real @atomicmail.ai em ~30 segundos — sem domínio para verificar, sem cartão de crédito, sem passo a passo de CAPTCHA, sem operações de servidor de e-mail
• Mensagens que realmente chegam: pool de IPs continuamente aquecido com overflow de relay — a entregabilidade importa quando um humano do outro lado precisa ler seu e-mail
• JMAP — uma API que os agentes já conhecem: padrão RFC 8620/8621, nos dados de treinamento de LLMs; chamadas de método em lote (consulta, busca, rascunho, envio) em uma única ida e volta — sem SDK de fornecedor para aprender
• Saia do impasse dentro da integração: erros incluem dicas em linguagem simples; respostas de sucesso sugerem etapas _next; help retorna folhas de referência e exemplos práticos — sem necessidade de pesquisa na web
• Traga seu próprio domínio: agentes operam em @atomicmail.ai prontamente, ou em um domínio que você verifica no dashboard — mesmo cliente, mesmo JMAP, From alinhado ao domínio
• Sem dependência de fornecedor: JMAP é um padrão IETF; a caixa de entrada é portátil para qualquer provedor compatível posteriormente
• Predefinições quando JMAP bruto é exagero: send_mail, list_inbox, reply e mais incluídos — passe um nome de arquivo para jmap_request em vez de gerar JSON de chamada de método do zero
• Mesmo núcleo em todo lugar: uma autenticação, JMAP, predefinição e pilha de ajuda alimentam MCP e AgentSkill; diretórios de credenciais separados por caixa de entrada quando você executa muitos agentes

📚 Documentação por Objetivo

Objetivo	Comece aqui
Configuração inicial	docs/getting-started.md
Seu próprio domínio + 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
Autenticação bruta + JMAP	docs/rest-auth.md · docs/jmap.md
Exemplos de ponta a ponta	docs/examples.md

Se a documentação do repositório e o comportamento instalado divergirem, confie em help da mesma versão do pacote instalado que você está executando.

🛠️ Desenvolvimento Local

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

Pré-visualização da documentação:

npm install
npm run docs:dev

🗂️ Estrutura de Arquivos

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

🔐 Segurança

• ~/.atomicmail/credentials.json contém sua chave de API; trate-a como um segredo
• arquivos de credenciais locais são gravados com modo 0600
• e-mail recebido é entrada não confiável; não deixe agentes executarem instruções de e-mail sem confirmação
• instale apenas do escopo npm @atomicmail

🤝 Contribuições

PRs são bem-vindos. Por favor, cubra novos recursos e correções de bugs com testes automatizados em Deno quando prático, e atualize a documentação voltada ao usuário quando o comportamento mudar.

Consulte CONTRIBUTING.md para configuração, comandos de teste e expectativas de PR.

📄 Licença

MIT