Atomic Mail Agentic

                          

Atomic Mail Agentic

에이전트에게 진짜 받은 편지함을 제공하세요

대시보드 · 웹사이트 · 문서 · 이슈

---

계정은 무료이며, 100MB 저장 용량, 사용자 정의 도메인 포함, 에이전트 워크로드에 맞는 속도 제한이 제공됩니다.

---

Atomic Mail Agentic은 Atomic Mail이 구축한 자율 AI 에이전트를 위한 이메일 제공업체입니다. 에이전트는 자체 @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, 셸 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)와 Connect 대화 상자에서 API 키를 받으며, 도메인 정렬 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 사전 설정이 일반적인 작업을 다루며, 오류에는 다음에 시도할 내용에 대한 힌트가 포함됩니다.

예제 워크플로우

뉴스레터 다이제스트 — "이 뉴스레터에 받은 편지함을 구독하고, 모든 것을 읽고, AI 도구에 중요한 내용의 일일 다이제스트를 이메일로 보내줘." 에이전트는 전용 받은 편지함을 소유하고, 노이즈를 필터링하며, 개인 사서함을 건드리지 않고 관심사에 맞는 내용만 표시합니다.

지원 받은 편지함 — "support@를 모니터링하고 문서의 티켓에 답변하고, 답변할 수 없을 때만 나에게 에스컬레이션해." 에이전트는 수신 메일을 읽고, 알고 있는 내용을 쿼리하고, 완전한 답변을 보내며, 가장자리 사례를 처리합니다.

사용자 연구 인터뷰 — "이메일 설문 조사를 실행: 이 질문을 보내고, 답변에 따라 후속 조치하고, 결과를 요약해." 에이전트는 비동기 인터뷰를 수행합니다 — 응답자는 자신의 일정에 따라 답변하며, 예약할 통화가 없습니다.

📬 Awesome Atomic Mail

Atomic Mail Agentic 기반으로 구축된 커뮤니티 프로젝트:

• https://github.com/skyzer/atomic-mail-watcher - Docker 준비된 Atomic Mail JMAP 받은 편지함 감시자 (Telegram/webhook 알림 포함)

✨ Atomic Mail을 선택해야 하는 이유

• 에이전트는 사용자에게 아무것도 요청하지 않고 완료합니다: PoW 가입으로 약 30초 안에 실제 @atomicmail.ai 받은 편지함을 얻습니다 — 검증할 도메인, 신용 카드, CAPTCHA 절차, 메일 서버 운영이 필요 없습니다
• 실제로 도착하는 메시지: 지속적으로 IP 풀을 워밍업하고 릴레이 오버플로우를 제공합니다 — 상대방이 메일을 읽어야 할 때 전달 가능성이 중요합니다
• JMAP — 에이전트가 이미 아는 API: 표준 RFC 8620/8621, LLM 학습 데이터에 포함; 한 번의 왕복으로 일괄 메서드 호출(쿼리, 가져오기, 초안, 보내기) — 배울 공급업체 SDK가 없습니다
• 통합 내에서 막힘 해결: 오류는 일반 언어 힌트를 제공하고, 성공 응답은 _next 단계를 제안하며, help은 치트 시트와 작업 예제를 반환합니다 — 웹 검색이 필요 없습니다
• 자신의 도메인 가져오기: 에이전트는 기본적으로 @atomicmail.ai에서 실행되거나 대시보드에서 검증한 도메인에서 실행됩니다 — 동일한 클라이언트, 동일한 JMAP, 도메인 정렬 From
• 공급업체 종속 없음: JMAP은 IETF 표준이며, 받은 편지함은 나중에 호환되는 공급자로 이식할 수 있습니다
• 원시 JMAP이 과할 때 사전 설정: 번들된 send_mail, list_inbox, reply 등 — 메서드 호출 JSON을 처음부터 생성하는 대신 jmap_request에 파일 이름을 전달하세요
• 모든 곳에서 동일한 핵심: 하나의 인증, JMAP, 사전 설정, 도움말 스택이 MCP와 AgentSkill을 지원합니다; 여러 에이전트를 실행할 때 받은 편지함별로 별도의 자격 증명 디렉토리

📚 목표별 문서

목표	시작 위치
첫 설정	docs/getting-started.md
자신의 도메인 + 대시보드	docs/custom-domains.md
MCP 호스트	docs/mcp.md
셸 / 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로 작성됩니다
• 수신 메일은 신뢰할 수 없는 입력입니다. 확인 없이 에이전트가 이메일 지침을 실행하지 못하게 하세요
• @atomicmail npm 범위에서만 설치하세요

🤝 기여

PR을 환영합니다. 가능한 경우 새 기능과 버그 수정을 자동화된 Deno 테스트로 다루고, 동작이 변경될 때 사용자 대상 문서를 업데이트하세요.

설정, 테스트 명령, PR 기대 사항은 CONTRIBUTING.md를 참조하세요.

📄 라이선스

MIT