---
title: "Run agent mailboxes and pull verification codes or reply context programmatically with Mails"
description: "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."
verification: "listed"
source: "https://github.com/chekusu/mails"
author: "chekusu"
publisher_type: "individual"
category:
  - "Calendar, Email & Productivity"
framework:
  - "Multi-Framework"
tool_ecosystem:
  github_repo: "chekusu/mails"
  github_stars: 294
  npm_package: "mails"
  npm_weekly_downloads: 1289
---

# 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

Choose whichever fits your setup:

1. Copy this skill folder into your local skills directory.
2. Clone the repo and symlink or copy the skill into your agent workspace.
3. Add the repo as a git submodule if you manage shared skills centrally.
4. Install it through your internal provisioning or packaging workflow.
5. Download the folder directly from GitHub and place it in your skills collection.

Install command or upstream instructions:

```
Install Mails from npm or use npx as documented upstream, claim or configure a mailbox, set any required sending or worker credentials, then run the send, inbox, code, or sync flows for the target automation.
```

## 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/)