Run agent mailboxes and pull verification codes or reply context programmatically with Mails
Give an agent a mailbox it can send from, read from, search, sync locally, and mine for login codes or attachments without hand-driving a normal email client.
Prerequisites
Node.js or Bun, Mails CLI or SDK, a claimed or self-hosted mailbox, optional Resend key for sending, optional Cloudflare Worker deployment for self-hosted mode
Installation
Use the upstream install or setup path that matches your environment:
- npm install -g mails
- npx mails
Requirements and caveats from upstream:
- All /api/* endpoints require Authorization: Bearer . The token must belong to the mailbox in ?to=, the email being fetched, or the from address being sent. /health is always public. If no mailbox token...
- bun test:live # Live E2E with real Resend + Cloudflare (requires .env)
Basic usage or getting-started notes:
| mails send --to user@example.com | email to agent@mails.dev
bash
or
Source: https://github.com/chekusu/mails
Extracted from upstream docs: https://raw.githubusercontent.com/chekusu/mails/HEAD/README.md