email-otp

# 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

```bash
# 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

```bash
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:**
```bash
python3 scripts/tempmail_otp.py create --domain "marcilzo.com"
```

### Check for OTP/Links

```bash
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:**
```bash
# Wait up to 2 minutes for OTP
python3 scripts/tempmail_otp.py check --timeout 120

# Only accept emails from noreply@example.com
python3 scripts/tempmail_otp.py check --sender "noreply@example.com"

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

### List Account and Messages

```bash
python3 scripts/tempmail_otp.py list
```...

# Email OTP Skill

A Python CLI tool and OpenClaw/Claude skill for creating temporary email addresses and automatically extracting OTP codes and validation links from incoming emails.

## Features

- **Free temporary email** - Uses mail.tm API (no API key required)
- **Automatic OTP extraction** - Detects 4-8 digit verification codes
- **Validation link extraction** - Extracts and saves verification URLs
- **Real-time monitoring** - Polls inbox for new messages with configurable timeout
- **Sender/subject filtering** - Only process emails from specific senders or with specific subjects
- **Unified state management** - All credentials and outputs stored in `~/.tempmail_otp/`

## Requirements

- Python 3.6+
- Standard library only (no external dependencies)
- Internet connection for mail.tm API

## Installation

1. Clone this repository:
```bash
git clone https://github.com/yourusername/skill-email-otp.git
cd skill-email-otp
```

2. Make the script executable (optional):
```bash
chmod +x scripts/tempmail_otp.py
```

3. (Optional) Install as a skill for OpenClaw/Claude:
   - Copy to `~/.openclaw/skills/email-otp/` or `~/.claude/skills/email-otp/`

## Quick Start

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

# Use the displayed email for signup, then monitor for OTP
python3 scripts/tempmail_otp.py check --once

# OTP is automatically saved to ~/.tempmail_otp/last_otp
cat ~/.tempmail_otp/last_otp
```

## Commands

### `create` - Create a temporary email account

```bash
python3 scripts/tempmail_otp.py create [OPTIONS]
```

| Option | Description |
|--------|-------------|
| `-e, --email ADDRESS` | Custom full email address |
| `-d, --domain DOMAIN` | Specific domain to use (check with `domains` command) |
| `-p, --password PASSWORD` | Account password (auto-generated if not specified) |
| `--json` | Output as JSON |

**Example:**
```bash
python3 scripts/tempmail_otp.py create --domain "marcilzo.com"
```

### `check` - Monitor inbox for O...