# 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.

- Skill: `agentskillexchange/run-agent-mailboxes-and-pull-verification-codes-or-reply-con` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/run-agent-mailboxes-and-pull-verification-codes-or-reply-con`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/run-agent-mailboxes-and-pull-verification-codes-or-reply-con/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/run-agent-mailboxes-and-pull-verification-codes-or-reply-con

---


# 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 <mailbox-token>. 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

## Documentation

- https://mails.dev

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/run-agent-mailboxes-and-pull-verification-codes-or-reply-context-programmatically-with-mails/)