← Back to Skills Marketplace
fantaclaw-ai

Disposable Email

by fantaclaw-ai · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ✓ Security Clean
157
Downloads
1
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install 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, ext...
README (SKILL.md)

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 \x3CTOKEN> --list

  • Read latest message:

    • python3 scripts/read_inbox.py --token \x3CTOKEN> --latest

  • Wait for OTP from incoming mail:

    • python3 scripts/read_inbox.py --token \x3CTOKEN> --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.
Usage Guidance
This skill appears to do what it says: create Mail.tm inboxes and read incoming messages/OTPs. Things to consider before installing or running it: (1) the scripts print mailbox tokens and can optionally save results to disk — treat those tokens like passwords and avoid running in environments where stdout or logs are shared; (2) disposable domains can be blocked by some services, so don't use this for critical production verification; (3) although the code only contacts api.mail.tm, be cautious if you later instruct an agent to forward inbox content — that could leak OTPs; (4) if you need more reliable CI usage, consider a paid/managed inbox provider. Overall the package is coherent and proportional to its stated purpose.
Capability Analysis
Type: OpenClaw Skill Name: disposable-email Version: 1.0.3 The skill bundle provides legitimate utility for automating temporary email creation and OTP extraction using the Mail.tm API. The scripts (create_inbox.py, read_inbox.py, e2e_otp.py) use standard Python libraries to interact with the official API and do not exhibit signs of data exfiltration, obfuscation, or unauthorized system access.
Capability Assessment
✓ Purpose & Capability
Name/description match the included scripts and SKILL.md. The bundled Python scripts call only the Mail.tm API to create accounts, obtain a bearer token, list messages, read messages, and extract OTPs — which is exactly what a disposable-email skill should do. There are no unrelated binaries, credentials, or config paths requested.
✓ Instruction Scope
SKILL.md instructs the agent to run the bundled scripts and describes expected JSON outputs. The scripts only perform network calls to https://api.mail.tm and local file writes when the explicit --save option is used. The instructions do not ask the agent to read unrelated files, environment variables, or transmit data to other endpoints.
✓ Install Mechanism
There is no install spec; this is an instruction + script bundle that uses only the Python standard library (urllib/json/etc.). Nothing is downloaded from arbitrary URLs or installed into uncommon locations.
✓ Credentials
The skill declares no env vars or credentials. It generates Mail.tm accounts and tokens at runtime (returned via stdout/JSON). Those tokens are mailbox-level credentials and the SKILL.md appropriately warns to keep them private. No unrelated secrets are requested.
✓ Persistence & Privilege
The skill is user-invocable and not always-enabled. It does not modify other skill or system configurations. It can write one result file if the user supplies --save (normal for this workflow).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install disposable-email
  3. After installation, invoke the skill by name or use /disposable-email
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Documentation updated: references to "Mail.tm" removed from the main heading for clarity. - No functional or script changes; only SKILL.md was revised.
v1.0.2
- Minor documentation update: clarified project title to "Disposable Email (Mail.tm)" in SKILL.md. - No changes to functionality or scripts.
v1.0.1
- Removed README.md file from the project. - No changes to code or skill functionality.
v1.0.0
- Initial release of disposable-email skill. - Create disposable Mail.tm inboxes and retrieve credentials via script. - List, read, and poll for inbox messages, OTP codes included. - Supports automation of email verification testing using Mail.tm. - Includes bundled Python scripts for end-to-end workflows.
Metadata
Slug disposable-email
Version 1.0.3
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 4
Frequently Asked Questions

What is 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, ext... It is an AI Agent Skill for Claude Code / OpenClaw, with 157 downloads so far.

How do I install Disposable Email?

Run "/install disposable-email" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Disposable Email free?

Yes, Disposable Email is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Disposable Email support?

Disposable Email is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Disposable Email?

It is built and maintained by fantaclaw-ai (@fantaclaw-ai); the current version is v1.0.3.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments