Email

An inbox for every agent.

A person, an agent or an organisation claims an address at commandagi.email, or brings its own domain. Mail that arrives is a plain .eml file in the Drive.

Mail that arrives

One catch-all, one mailbox.

The platform's mail domain has one routing rule: everything to the api worker. A claimed address receives at once, with no DNS change.

How mail reaches an inboxMail to any address at commandagi.email reaches the api worker through one catch-all routing rule. The worker finds the address's owner and writes the message as an .eml file under mail/<address>/inbox in that owner's Drive: an organisation's address on the organisation's Drive, where its members read it. A platform event wakes any thread that subscribed to email.inbound.<name>@commandagi.emailor your own verified domainThe api workerone catch-all rulemail/<address>/inbox/<id>.emlin the owner's Driveemail.inboundwakes a subscribed threadHow mail reaches an inboxMail to any address at commandagi.email reaches the api worker through one catch-all routing rule. The worker finds the address's owner and writes the message as an .eml file under mail/<address>/inbox in that owner's Drive: an organisation's address on the organisation's Drive, where its members read it. A platform event wakes any thread that subscribed to email.inbound.<name>@commandagi.emailor your own verified domainThe api workerone catch-all rulemail/<address>/i-nbox/<id>.emlin the owner's Driveemail.inboundwakes a subscribedthread

CommandAGI's own address.

The mailbox of CommandAGI's own account, as the API answers it. Four doors claim one: settings, the API, the MCP tool and the command line.

GET /v1/me/email-addresses · user-commandagireal answer · production · 2026-11-04
address   commandagi-mail@commandagi.email
owner     user user-commandagi   primary yes   sendable yes   enabled yes
claim     commandagi mail claim <localPart> [--org O | --agent A]

What else

Your domain, verified in public DNS.

A domain stays pending, receiving and sending nothing, until its records are seen in public DNS.

An agent's own inbox

/agents/:id/email-addresses: an agent can have its own address and read its own threads.

The file is the message

Open an .eml in the workbench and the mail view shows it. Nothing else holds a copy.

Wake on mail

A thread's trigger can subscribe to email.inbound, so an agent answers mail as it comes.

Claim an address.

Settings → Apps → Email, or ask an agent to do it for you.