Mailbox identity
A unique address belongs to the agent or workflow and has a known lifecycle.
Give the agent a dedicated mailbox and a bounded retrieval interface rather than access to a human webmail account.
An AI agent can receive email by using a programmable mailbox service that creates an address, routes inbound messages, stores them, and exposes scoped retrieval tools. With mails0, the official CLI or MCP server can bootstrap a temporary receive-only mailbox automatically; the agent then uses inbox, search, code, message, or thread operations to retrieve only the required result.
Four components are required
A unique address belongs to the agent or workflow and has a known lifecycle.
The domain routes external mail to a service that can parse and store the message.
The agent can access only its mailbox and only the capabilities needed.
An API, CLI, SDK, MCP tool, webhook, or stream returns bounded message results.
A unique address belongs to the agent or workflow and has a known lifecycle.
The domain routes external mail to a service that can parse and store the message.
The agent can access only its mailbox and only the capabilities needed.
An API, CLI, SDK, MCP tool, webhook, or stream returns bounded message results.
Run mails bootstrap or call an inbox tool from the configured MCP server.
Enter the generated address in the signup, notification, or test workflow.
Call the inbox or code operation with a deadline and expected recipient.
Use the code, link, message, or structured field and keep the message ID for traceability.
mails bootstrap
mails inbox --direction inbound --limit 5A personal mailbox contains unrelated messages, recovery links, and sensitive history. A dedicated agent mailbox starts empty, can be revoked independently, and limits accidental context exposure.
Inbound content remains untrusted. Validate sender context, links, attachments, and workflow eligibility before the agent uses other tools.
| Need | Recommended model | Tradeoff |
|---|---|---|
| One code or signup | Temporary agent inbox | Short lifecycle and no sending. |
| Recurring agent notifications | Permanent scoped mailbox | Requires ownership and retention policy. |
| Existing employee email | Provider-native mailbox API | OAuth scopes and human data review. |
| Production owned domain | Self-hosted agent mailbox | Team owns DNS, data, provider, and incidents. |
Keep the recipient and start time in the run state, return only the needed result, and retain a message identifier for diagnosis. Stop or rotate the mailbox when the task ends so a one-time experiment does not become an unowned identity.
Product behavior is verified against the mails0 source and documentation. External comparisons link to official vendor documentation checked on 2026-08-15.
Yes. The mails0 CLI and MCP server can bootstrap a provisional receive-only inbox automatically within hosted limits.
Eligible mailbox tools can retrieve attachment metadata and content. Validate type and size before passing attachments to other tools.
No. The hosted provisional mailbox is receive-only and is sufficient for codes, links, and notifications.
Start with a receive-only temporary mailbox. Move to a permanent identity or self-hosted deployment only after the workflow reaches a real email value event.