Atomic Mail Agentic

                          

Atomic Mail Agentic

Beri agen Anda kotak masuk sungguhan

Dasbor · Situs Web · Dokumentasi · Masalah

---

Akun gratis, dengan kuota penyimpanan 100 MB, domain kustom disertakan, dan batas kecepatan yang disesuaikan untuk beban kerja agen.

---

Atomic Mail Agentic adalah penyedia email untuk agen AI otonom, dibangun oleh Atomic Mail. Agen mendaftarkan kotak masuk @atomicmail.ai mereka sendiri dan mengelolanya dari awal hingga akhir — tanpa penyiapan manual, verifikasi, atau intervensi berkelanjutan dari manusia.

Layanan ini dibangun di atas JMAP (RFC 8620), sehingga agen mendapatkan API kotak masuk lengkap: baca dan kirim email, buat draf, kelola utas, cari, dan banyak lagi. JMAP terwakili dengan baik dalam data pelatihan LLM, sehingga model sudah lancar menggunakannya — mereka jarang berhalusinasi tentang bentuk permintaan, yang berarti lebih sedikit percobaan ulang dan otomatisasi yang lebih andal.

Akses dijaga oleh protokol pendaftaran proof-of-work (PoW) yang baru: properti anti-penyalahgunaan yang kuat tanpa CAPTCHA atau persetujuan manual, sehingga agen dapat bergabung dan beroperasi sepenuhnya tanpa campur tangan.

Atomic Mail menyediakan sejumlah jalur integrasi standar — MCP, AgentSkill, REST API, dan lainnya — yang membuatnya sangat mudah digunakan di agen mana pun: Claude Code, Codex, GitHub Copilot, Cursor, Hermes, OpenClaw, Pi, Kilo Code, dan lainnya. Apa pun alur kerja Anda, Anda dapat mengotomatiskan manajemen kotak masuk dengan mudah.

Repositori ini mengirimkan integrasi klien: MCP, CLI shell, ClawHub, plugin Dify, dan lainnya, yang mengekspos API tersebut melalui tiga alat: register, jmap_request, dan help. Semua konektor di repo ini cukup tipis dan terutama diperlukan untuk mengabstraksi kompleksitas protokol PoW.

🚀 Instalasi Cepat

💬 Prompt Siap Pakai (agen apa pun)

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)

Tambahkan ini ke konfigurasi host MCP Anda (atau cukup minta agen Anda melakukannya):

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

Lalu mulai ulang host dan minta agen Anda membuat kotak masuk.

🦞 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

Hanya untuk konektor kustom dan logika lanjutan

Lihat dokumentasi: docs/rest-auth.md.

🌐 Domain Kustom & Dasbor

Secara default, kotak masuk berada di <name>@atomicmail.ai, dibuat tanpa campur tangan melalui pendaftaran PoW. Untuk mengirim dari domain Anda sendiri (support@yourcompany.com), atur sekali di dasbor — bidang kendali manusia yang terpisah dari alur agen, karena memerlukan perubahan DNS pada domain yang Anda miliki.

Di sana Anda menambahkan dan memverifikasi domain (kepemilikan TXT + catatan MX; dapat dijalankan ulang, propagasi biasanya beberapa menit) dan membuat kotak masuk di domain tersebut — masing-masing mendapatkan alamat lengkap (agent@yourcompany.com) dan kunci API dari dialog Connect, dengan pengiriman yang ditandatangani untuk From yang selaras dengan domain.

Klien tidak berubah — jmap_request, preset, dan bentuk JMAP yang sama. Kotak masuk domain kustom adalah login, bukan pendaftaran PoW: sambungkan dengan kunci API-nya (atomicmail register --api-key "…") atau OAuth. $INBOX diselesaikan ke alamat asli (agent@yourcompany.com), sehingga pengalamatan sendiri dan From tetap benar tanpa konfigurasi tambahan.

Panduan lengkap: docs/custom-domains.md.

🤖 Apa yang Dapat Dilakukan Agen Anda

Atomic Mail dirancang untuk dijalankan melalui agen — bukan melalui penyiapan kotak masuk manual. Anda menjelaskan alur kerja dalam bahasa sehari-hari; agen mendaftarkan alamat @atomicmail.ai, mengirim dan menerima email, serta menjaga utas tetap berjalan. Anda tidak perlu mengonfigurasi skrip, menyalin kunci API antar tab, atau menghafal JMAP. Semuanya otomatis.

Jika agen macet, integrasi dirancang untuk pulih sendiri: help menyertakan dokumentasi bawaan (preset, cron, pemecahan masalah), preset JSON yang dibundel mencakup operasi umum, dan kesalahan menyertakan petunjuk tentang apa yang harus dicoba selanjutnya.

Contoh alur kerja

Ringkasan buletin — "Langgankan kotak masuk Anda ke buletin ini, baca semuanya, dan kirimkan saya ringkasan harian tentang hal yang penting untuk perkakas AI." Agen memiliki kotak masuk khusus, menyaring kebisingan, dan hanya menampilkan yang sesuai dengan minat Anda — tanpa menyentuh kotak masuk pribadi Anda.

Kotak masuk dukungan — "Pantau support@ dan balas tiket dari dokumentasi kami; eskalasikan ke saya hanya jika Anda tidak dapat menjawab." Agen membaca email masuk, menelusuri apa yang diketahuinya, mengirim balasan lengkap, dan menyerahkan kasus tepi.

Wawancara riset pengguna — "Jalankan survei email: kirim pertanyaan ini, tindak lanjuti berdasarkan balasan, dan rangkum temuan." Agen melakukan wawancara asinkron — responden membalas sesuai jadwal mereka sendiri, tanpa perlu menjadwalkan panggilan.

📬 Awesome Atomic Mail

Proyek komunitas yang dibangun di atas Atomic Mail Agentic:

• https://github.com/skyzer/atomic-mail-watcher - Pemantau kotak masuk Atomic Mail JMAP siap-Docker dengan notifikasi Telegram/webhook

✨ Mengapa Atomic Mail

• Agen selesai tanpa meminta apa pun dari penggunanya: pendaftaran PoW memberikan kotak masuk @atomicmail.ai sungguhan dalam ~30 detik — tanpa verifikasi domain, tanpa kartu kredit, tanpa panduan CAPTCHA, tanpa operasi server email
• Pesan yang benar-benar tiba: kumpulan IP yang terus dihangatkan dengan luapan relay — keterkiriman penting ketika manusia di sisi lain harus membaca email Anda
• JMAP — API yang sudah dikenal agen: standar RFC 8620/8621, ada dalam data pelatihan LLM; panggilan metode batch (kueri, ambil, draf, kirim) dalam satu perjalanan pulang-pergi — tanpa SDK vendor yang harus dipelajari
• Keluar dari kebuntuan di dalam integrasi: kesalahan menyertakan petunjuk bahasa sederhana; respons sukses menyarankan langkah _next; help mengembalikan lembar contekan dan contoh yang sudah dikerjakan — tanpa pencarian web
• Bawa domain Anda sendiri: agen berjalan di @atomicmail.ai langsung, atau di domain yang Anda verifikasi di dasbor — klien yang sama, JMAP yang sama, From yang selaras dengan domain
• Tanpa kunci vendor: JMAP adalah standar IETF; kotak masuk dapat dipindahkan ke penyedia yang sesuai mana pun nanti
• Preset saat JMAP mentah berlebihan: send_mail, list_inbox, reply, dan lainnya yang dibundel — berikan nama file ke jmap_request alih-alih membuat JSON panggilan metode dari awal
• Inti yang sama di mana pun: satu autentikasi, JMAP, preset, dan tumpukan bantuan mendukung MCP dan AgentSkill; direktori kredensial terpisah per kotak masuk saat Anda menjalankan banyak agen

📚 Dokumentasi Berdasarkan Tujuan

Tujuan	Mulai di sini
Penyiapan pertama kali	docs/getting-started.md
Domain Anda sendiri + dasbor	docs/custom-domains.md
Host MCP	docs/mcp.md
Agen shell / cron	docs/skill-install.md
Agen LangChain	docs/langchain.md
Buku panduan agen	docs/SKILL.md
Autentikasi mentah + JMAP	docs/rest-auth.md · docs/jmap.md
Contoh dari awal hingga akhir	docs/examples.md

Jika dokumentasi repo dan perilaku terinstal pernah menyimpang, percayai help dari versi paket terinstal yang sama dengan yang Anda jalankan.

🛠️ Pengembangan Lokal

Prasyarat: 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

Pratinjau dokumentasi:

npm install
npm run docs:dev

🗂️ Struktur File

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

🔐 Keamanan

• ~/.atomicmail/credentials.json berisi kunci API Anda; perlakukan sebagai rahasia
• file kredensial lokal ditulis dengan mode 0600
• email masuk adalah input yang tidak tepercaya; jangan biarkan agen mengeksekusi instruksi email tanpa konfirmasi
• instal hanya dari lingkup npm @atomicmail

🤝 Kontribusi

PR diterima. Harap mencakup fitur baru dan perbaikan bug dengan tes Deno otomatis jika memungkinkan, dan perbarui dokumentasi yang menghadap pengguna saat perilaku berubah.

Lihat CONTRIBUTING.md untuk penyiapan, perintah tes, dan ekspektasi PR.

📄 Lisensi

MIT