atomicmail

name	atomicmail
description	Read and write email through the Atomic Mail from an AI agent. Handles proof-of-work authentication and JMAP so the agent thinks in JMAP method calls. Use when the user asks to register an email inbox, list mailboxes, fetch or send email.
version	0.3.14
author	Atomic Mail
license	MIT
platforms	["macos","linux","windows"]
metadata	{"openclaw":{"requires":{"bins":["node"]},"homepage":"https://atomicmail.ai"},"hermes":{"tags":["Productivity","Email","Communication","blueprint"],"config":[{"key":"atomicmail.credentials_dir","description":"Directory for Atomic Mail credentials and JWT files","default":"~/.hermes/atomicmail","prompt":"Atomic Mail credentials directory"}],"blueprint":{"schedule":"0 * * * *","deliver":"origin","no_agent":false,"prompt":"Use ${HERMES_SKILL_DIR}/scripts/atomicmail jmap_request --ops-file list_inbox.json to fetch my inbox. Summarize new messages, highlight what needs a reply, and stay available — I may ask you to reply, forward, search, or dig into something important.\n"}}}
required_environment_variables	[{"name":"ATOMIC_MAIL_CREDENTIALS_DIR","prompt":"Atomic Mail credentials directory","help":"Default on Hermes is ~/.hermes/atomicmail (not ~/.atomicmail). The skill launcher sets ATOMIC_MAIL_CREDENTIALS_DIR when unset. Override only for multi-account setups.","required_for":"register and jmap_request credential paths"},{"name":"ATOMIC_MAIL_AUTH_URL","prompt":"Atomic Mail auth service URL","help":"Override default https://auth.atomicmail.ai","required_for":"custom auth endpoint"},{"name":"ATOMIC_MAIL_API_URL","prompt":"Atomic Mail JMAP API URL","help":"Override default https://api.atomicmail.ai","required_for":"custom API endpoint"},{"name":"ATOMIC_MAIL_SCRYPT_SALT","prompt":"Atomic Mail PoW scrypt salt override","help":"Only override when directed by Atomic Mail support","required_for":"PoW registration salt override"},{"name":"ATOMIC_MAIL_API_KEY","prompt":"Atomic Mail API key","help":"Optional — use register with --api-key or store in credentials.json","required_for":"existing-account login without credentials.json"}]
required_credential_files	[{"path":"atomicmail/credentials.json","description":"Atomic Mail API key and account metadata (created by register)"},{"path":"atomicmail/session.jwt","description":"JMAP session JWT (created by register)"},{"path":"atomicmail/capability.jwt","description":"JMAP capability JWT (created by register)"}]

Atomic Mail

Atomic Mail exposes a programmable inbox over JMAP with PoW signup and JWT rotation. This skill ships a single CLI entrypoint with three commands: register, jmap_request, and help — matching the MCP server.

When to use this skill

• Register a new inbox or log in with an existing API key.
• Send JMAP batches (inline JSON or preset files).
• Read built-in documentation (JMAP cheatsheet, presets, troubleshooting) or the package README (atomicmail help --topic readme).

Call atomicmail help early and often — before guessing placeholders, using URNs, or cron setup. Start with help --topic overview, then presets before custom jmap_request calls and cron after register. If installed behavior disagrees with docs elsewhere, trust help from the running package.

Commands

{baseDir}/scripts/atomicmail register --username "myagent"

{baseDir}/scripts/atomicmail jmap_request --ops-file list_inbox.json

Run atomicmail --help or atomicmail <command> --help for flags.

Defaults

• authUrl: https://auth.atomicmail.ai
• apiUrl: https://api.atomicmail.ai
• credentials directory: ~/.atomicmail

Workflow

1. Register (new account)

{baseDir}/scripts/atomicmail register \
  --username "alice"

Writes credentials.json, session.jwt, capability.jwt. Prints JSON including inbox and accountId.

Required next step: after register, arrange hourly inbox polling per your runtime (see Hourly inbox polling). Native cron hosts schedule an agent job with list_inbox.json; hosts without native cron should ask the operator or remind manual fetch. Do not cron alone.