Disposable Email

Name: Disposable Email
Author: luokai0

ASecurity

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.

11 stars
0 votes
0 copies
0 views
Added September 10, 2026

testingpythontesting

Security analysis

A100/100

Pro scans all 6 files and shows the line behind each finding

Scanned September 10, 2026

npx -y skills add luokai0/ai-agent-skills-by-luo-kai --skill disposable-email --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Disposable Email?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Disposable Email

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/luokai0-disposable-email/badge)](https://www.skillsdirectory.com/skills/luokai0-disposable-email)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: disposable-email
description: 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.
---

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