Email OTP Skill

A skill for creating temporary email addresses and automatically extracting OTP codes and validation links from incoming emails. Uses the free mail.tm API (no API key required).

When to Use This Skill

Invoke this skill when the user asks to:

• Create a temporary email address
• Get a disposable email for signup/verification
• Check for OTP (one-time password) codes
• Wait for email verification links
• Monitor an inbox for authentication codes

Quick Start

# Create a new temporary email
python3 scripts/tempmail_otp.py create

# Monitor for OTP codes (5 minute timeout)
python3 scripts/tempmail_otp.py check

# List current account and messages
python3 scripts/tempmail_otp.py list

Commands

Create Account

python3 scripts/tempmail_otp.py create [OPTIONS]

Options:

• -e, --email ADDRESS - Custom full email address
• -d, --domain DOMAIN - Specific domain to use
• -p, --password PASSWORD - Account password (auto-generated if not specified)
• --json - Output as JSON

Example:

python3 scripts/tempmail_otp.py create --domain "marcilzo.com"

Check for OTP/Links

python3 scripts/tempmail_otp.py check [OPTIONS]

Options:

• --timeout SECONDS - Max seconds to wait (default: 300)
• --poll SECONDS - Poll interval in seconds (default: 3)
• --sender EMAIL - Only accept emails from this sender
• --subject TEXT - Only accept emails with this in subject
• --pattern REGEX - Custom regex pattern for OTP extraction
• --once - Exit after first OTP found
• --json - Output messages as JSON

Examples:

# Wait up to 2 minutes for OTP
python3 scripts/tempmail_otp.py check --timeout 120

# Only accept emails from [email protected]
python3 scripts/tempmail_otp.py check --sender "[email protected]"

# Exit immediately after finding OTP
python3 scripts/tempmail_otp.py check --once

List Account and Messages

python3 scripts/tempmail_otp.py list

Shows the current account details and all messages in the inbox with extracted links.

List Available Domains

python3 scripts/tempmail_otp.py domains [--json]

Output Files

When an OTP or link is found, the script automatically saves them to the unified state directory:

• ~/.tempmail_otp/last_otp - Contains the last extracted OTP code
• ~/.tempmail_otp/last_link - Contains the first interesting validation link found
• ~/.tempmail_otp/account.json - Account credentials (JWT token, email, password)

All state files are stored in ~/.tempmail_otp/ with restricted permissions (0600).

OTP Detection Patterns

The script automatically detects OTP codes using these patterns:

• 6-8 digit numbers (most common)
• 4 digit numbers
• "code: XXXXXX" format
• "verification: XXXXXX" format
• "otp: XXXXXX" format

Link Extraction