mails-skills

<p align="center">
  <h1 align="center">mails-skills</h1>
  <p align="center">
    Your AI agent can now sign up for any service. Verification codes handled automatically.
  </p>
  <p align="center">
    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
    <a href="#supported-platforms"><img src="https://img.shields.io/badge/platforms-Claude_Code_%7C_OpenClaw_%7C_Cursor_%7C_Any_Agent-brightgreen.svg" alt="Platforms"></a>
    <a href="https://www.npmjs.com/package/mails-agent"><img src="https://img.shields.io/npm/v/mails-agent.svg?label=mails-agent%20CLI" alt="npm version"></a>
  </p>
</p>

---

**Your agent hits "enter verification code" and stops.** Not anymore. `mails-skills` gives any AI agent the ability to receive verification codes and complete service registrations autonomously. One API call: `GET /api/code?timeout=60`.

## What Your Agent Can Do

| Capability | Example |
|---|---|
| **Auto-register for services** | **Full flow: fill form, wait for code, verify. Zero human intervention.** |
| **Extract verification codes** | **"Sign up on example.com and enter the code"** |
| Receive emails | "Check my inbox for new messages" |
| Send emails | "Send a summary report to [email protected]" |
| Search inbox | "Find all emails from GitHub" |
| Download attachments | "Get the PDF from that invoice email" |
| Conversation threads | "Show me the full thread with Alice" |
| Filter by label | "Show me all newsletters" (newsletter, notification, code, personal) |
| Extract structured data | "Extract the order details from that confirmation email" (order, shipping, calendar, receipt) |

## Quick Start

### Option A: Hosted (2 commands)

```bash
npm install -g mails-agent    # Install the CLI
mails claim myagent           # Claim [email protected] (free)
```

Then install the skill:

```bash
git clone https://github.com/Digidai/mails-skills && cd mails-skills && ./install.sh
```

The installer auto-detects your config