# Disposable Email

> Create disposable Mail.tm inboxes and programmatically read incoming emails/OTP codes. Use when asked to generate a temporary email, poll inbox messages, extract OTPs, or automate email verification testing with Mail.tm.

- Skill: `luokai0/disposable-email` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add luokai0/disposable-email`
- Raw SKILL.md: https://api.skillmd.com/api/skills/luokai0/disposable-email/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: luokai0 (https://skillmd.com/u/luokai0)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/luokai0/disposable-email

---


# Disposable Email

Create and read temporary Mail.tm inboxes for testing email flows.

## Use bundled scripts

- Create inbox + token:
  - `python3 scripts/create_inbox.py`
  - Returns JSON with `address`, `password`, `token`, `accountId`, `domain`.

- List messages:
  - `python3 scripts/read_inbox.py --token <TOKEN> --list`

- Read latest message:
  - `python3 scripts/read_inbox.py --token <TOKEN> --latest`

- Wait for OTP from incoming mail:
  - `python3 scripts/read_inbox.py --token <TOKEN> --wait-otp --timeout 120 --interval 3`
  - Default OTP regex: `\\b(\\d{4,8})\\b`
  - Override regex with `--otp-regex`.

- End-to-end (create inbox + wait for first message/OTP):
  - `python3 scripts/e2e_otp.py --timeout 120 --interval 3`
  - First line emits `inbox_created` JSON (address/password/token).
  - Then emits one of: `otp_found`, `message_received_no_otp`, or `timeout`.
  - Add `--save ./otp-result.json` to persist the latest emitted result to disk.

## Workflow

1. Run `create_inbox.py` and share the generated email address.
2. Trigger email delivery to that address.
3. Poll with `read_inbox.py` (`--latest` or `--wait-otp`).
4. Return sender, subject, createdAt, and message text/OTP.

## Notes

- Free temp domains can be blocked by some production services.
- Keep token private; treat it like mailbox access credentials.
- Prefer stable paid inbox providers for CI if reliability is critical.