# Mailagent

Temporary inboxes for agent signup QA, create disposable addresses, wait for...

- Repository: https://github.com/hashgraph-online/awesome-codex-plugins (1479 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add hashgraph-online/awesome-codex-plugins --skill mailagent -g -a claude-code -y`
Codex: `npx skills add hashgraph-online/awesome-codex-plugins --skill mailagent -g -a codex -y`
Cursor: `npx skills add hashgraph-online/awesome-codex-plugins --skill mailagent -g -a cursor -y`
Gemini CLI: `npx skills add hashgraph-online/awesome-codex-plugins --skill mailagent -g -a gemini-cli -y`

## Description

Temporary inboxes for agent signup QA, create disposable addresses, wait for verification email, extract OTP or magic links. Use when automating signup, login, or email verification without parsing HTML manually.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# MailAgent

MailAgent provides **programmatic disposable inboxes** for AI agents: receive OTP codes and magic links during signup flows, simulate inbound mail in CI, send/reply on verified domains, and diagnose timeouts.

Official docs: https://webmailagent.com/docs/agents.html

## When to use

- Signup or login that sends a verification email
- Need OTP or magic link without hand-parsing HTML
- E2E / agent task: "register with a temp email"
- QA without real SMTP (`mailagent_simulate_message`)
- **Not** for human privacy burners, programmatic agent inboxes with allowlists

## Install (pick one)

### Cursor (project)

MCP in `.cursor/mcp.json` → `@mailagent/mcp` or `mcp/dist/index.js`. Skill auto-loads from `.cursor/skills/mailagent-mcp/` (synced from this file).

### Agent Skills catalog (repo root)

```bash
npx skills add Alex0nder/MailAgent --skill mailagent
```

### OpenAI Codex

```bash
codex plugin marketplace add Alex0nder/MailAgent
codex plugin add mailagent@mailagent
```

Guide: https://webmailagent.com/docs/codex.html

### npm MCP (any client)

```bash
export MAILAGENT_API_URL=https://api.webmailagent.com
export MAILAGENT_API_KEY=ma_…
npx -y -p @mailagent/mcp@0.2.16 mailagent-mcp
```

Remote (no subprocess): `POST https://api.webmailagent.com/mcp` + Bearer token.

### SDK (without MCP)

| Package | Install |
|---------|---------|
| `@mailagent/agent` | `npm install @mailagent/agent` |
| `@mailagent/qa` | `npm install @mailagent/qa` (Playwright) |
| `mailagent-agent` | `pip install mailagent-agent` (Python) |

**Browser login (no API key in client):** Auth0 OIDC on prod, `auth.oidc: enabled` on `GET /v1/agent`. Operator setup: `npm run wizard:auth0`. Docs: https://webmailagent.com/docs/oauth-idp.html

## Prerequisites

The rest: https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/Alex0nder/MailAgent/skills/mailagent/SKILL.md