Atomic Mail Agentic

                          

Atomic Mail Agentic

Дайте вашему агенту настоящий почтовый ящик

Панель управления · Веб-сайт · Документация · Проблемы

---

Аккаунты бесплатны, с квотой хранилища 100 МБ, включённым пользовательским доменом и лимитами скорости, рассчитанными на рабочие нагрузки агентов.

---

Atomic Mail Agentic — это почтовый провайдер для автономных ИИ-агентов, созданный компанией Atomic Mail. Агенты регистрируют собственный почтовый ящик @atomicmail.ai и управляют им от начала до конца — без участия человека, проверок или постоянного вмешательства.

Сервис построен на JMAP (RFC 8620), поэтому агенты получают полноценный API почтового ящика: чтение и отправка писем, создание черновиков, управление цепочками, поиск и многое другое. JMAP хорошо представлен в обучающих данных LLM, поэтому модели уже свободно говорят на нём — они редко галлюцинируют формы запросов, что означает меньше повторных попыток и более надёжную автоматизацию.

Доступ ограничен новым протоколом регистрации на основе доказательства работы (PoW): сильные свойства защиты от злоупотреблений без CAPTCHA или ручного одобрения, поэтому агенты могут подключаться и работать полностью без участия человека.

Atomic Mail предоставляет ряд стандартных путей интеграции — MCP, AgentSkill, REST API и другие, — что делает его доступным на любом агенте: Claude Code, Codex, GitHub Copilot, Cursor, Hermes, OpenClaw, Pi, Kilo Code и других. Какой бы ни был ваш рабочий процесс, вы можете легко автоматизировать управление почтовым ящиком.

Этот репозиторий содержит клиентские интеграции: MCP, shell CLI, ClawHub, плагин Dify и другие, предоставляя эти API через три инструмента: register, jmap_request и help. Все коннекторы в этом репозитории довольно тонкие и в основном нужны для абстрагирования сложностей протокола 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.

🔌 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) и API-ключ из диалога Connect, с подписью отправки для доменного 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-пресеты покрывают типовые операции, а ошибки содержат подсказки, что попробовать дальше.

Примеры рабочих процессов

Дайджест новостей — «Подпиши свой почтовый ящик на эти рассылки, прочитай всё и отправляй мне ежедневный дайджест того, что важно для ИИ-инструментов». Агент владеет выделенным почтовым ящиком, фильтрует шум и показывает только то, что соответствует вашим интересам — не касаясь вашего личного почтового ящика.

Почта поддержки — «Отслеживай support@ и отвечай на тикеты из нашей документации; эскалируй мне только тогда, когда не можешь ответить». Агент читает входящую почту, запрашивает свои знания, отправляет полные ответы и передаёт сложные случаи.

Интервью для пользовательских исследований — «Проведи email-опрос: отправь эти вопросы, следуй за ответами и обобщи результаты». Агент проводит асинхронные интервью — респонденты отвечают по своему графику, никаких звонков для бронирования.

📬 Awesome Atomic Mail

Сообщественные проекты, построенные на Atomic Mail Agentic:

• https://github.com/skyzer/atomic-mail-watcher - Docker-ready наблюдатель за почтовым ящиком Atomic Mail JMAP с уведомлениями через Telegram/webhook

✨ Почему Atomic Mail

• Агенты завершают работу, не прося пользователей ни о чём: регистрация PoW даёт настоящий почтовый ящик @atomicmail.ai примерно за 30 секунд — без проверки домена, кредитной карты, прохождения CAPTCHA или операций с почтовым сервером
• Сообщения, которые действительно доставляются: постоянно прогреваемый пул IP-адресов с резервным релеем — доставляемость важна, когда человек на другой стороне должен прочитать вашу почту
• JMAP — API, который агенты уже знают: стандарт RFC 8620/8621, присутствует в обучающих данных LLM; пакетные вызовы методов (запрос, получение, черновик, отправка) за один круговой обход — не нужно учить вендорный SDK
• Выход из тупика внутри интеграции: ошибки содержат подсказки на простом языке; успешные ответы предлагают шаги _next; help возвращает шпаргалки и рабочие примеры — без поиска в вебе
• Принесите свой домен: агенты работают на @atomicmail.ai из коробки или на домене, который вы проверяете в панели управления — тот же клиент, тот же JMAP, доменный From
• Без привязки к вендору: JMAP — стандарт IETF; почтовый ящик можно перенести к любому совместимому провайдеру позже
• Пресеты, когда сырой JMAP избыточен: встроенные send_mail, list_inbox, reply и другие — передайте имя файла в jmap_request вместо генерации JSON вызовов методов с нуля
• Одно ядро везде: одна аутентификация, JMAP, пресеты и стек помощи питают MCP и AgentSkill; отдельные каталоги учётных данных для каждого почтового ящика при запуске многих агентов

📚 Документация по целям

Цель	Начните здесь
Первоначальная настройка	docs/getting-started.md
Свой домен + панель управления	docs/custom-domains.md
MCP-хосты	docs/mcp.md
Shell / cron-агенты	docs/skill-install.md
LangChain-агенты	docs/langchain.md
Руководство агента	docs/SKILL.md
Сырая аутентификация + JMAP	docs/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
• входящая почта — это недоверенный ввод; не позволяйте агентам выполнять инструкции из писем без подтверждения
• устанавливайте только из npm-скоупа @atomicmail

🤝 Вклад в проект

PR приветствуются. Пожалуйста, покрывайте новые функции и исправления ошибок автоматизированными тестами Deno, где это практично, и обновляйте пользовательскую документацию при изменении поведения.

См. CONTRIBUTING.md для настройки, команд тестирования и ожиданий по PR.

📄 Лицензия

MIT