Generate and manage disposable temporary email addresses on demand for anonymity. Use when the user asks for fake emails, throwaway addresses, temp mail, disposable email, anonymous email, burner email, or needs email addresses for testing/signup. Supports batch generation (up to 20+), inbox checking, and message reading.
Generate and manage throwaway email addresses using free public APIs. No API keys, no auth, no signup required.
Backends:
api.guerrillamail.com. Emails last ~1 hour.api.tempmail.lol. Alternative backend if GuerrillaMail has issues.python3 ~/.claude/skills/tempmail/scripts/tempmail.py <command>
# Generate 1 random email (GuerrillaMail, default)
python3 ~/.claude/skills/tempmail/scripts/tempmail.py generate
# Generate 5 random emails
python3 ~/.claude/skills/tempmail/scripts/tempmail.py generate -n 5
# Custom username prefix
python3 ~/.claude/skills/tempmail/scripts/tempmail.py generate -n 3 -p testuser
# Use tempmail.lol backend instead
python3 ~/.claude/skills/tempmail/scripts/tempmail.py generate -b tempmail.lol
# Batch with tempmail.lol
python3 ~/.claude/skills/tempmail/scripts/tempmail.py generate -n 5 -b tempmail.lol
# Check one inbox (auto-detects backend from store)
python3 ~/.claude/skills/tempmail/scripts/tempmail.py inbox [email protected]
# Check ALL tracked email inboxes at once
python3 ~/.claude/skills/tempmail/scripts/tempmail.py check-all
# Read message by ID (get IDs from inbox check)
python3 ~/.claude/skills/tempmail/scripts/tempmail.py read [email protected] 12345
# List all tracked emails
python3 ~/.claude/skills/tempmail/scripts/tempmail.py list
# List only recently created (< 1 hour)
python3 ~/.claude/skills/tempmail/scripts/tempmail.py list --active
# Show available domains
python3 ~/.claude/skills/tempmail/scripts/tempmail.py domains
# Purge all tracked emails from local store
python3 ~/.claude/skills/tempmail/scripts/tempmail.py purge
All output is JSON — parse it directly. Example generate output:
{
"generated": 1,
"emails": [
{
"address": "[email protected]",
"sid_token": "abc...",
"backend": "guerrilla",
"created_at": "2026-03-29T..."
}
]
}
~/.claude/tempmail_store.json. The session tokens (sid_token for GuerrillaMail, token for tempmail.lol) are required for inbox access.Base URL: https://api.guerrillamail.com/ajax.php
| Action | Params | Description |
|---|---|---|
f=get_email_address | (none) | Get a new random email + session token |
f=set_email_user | email_user=NAME&sid_token=SID | Set custom username |
f=check_email | seq=0&sid_token=SID | Check inbox for new messages |
f=fetch_email | email_id=ID&sid_token=SID | Read a specific email |
Base URL: https://api.tempmail.lol/v2
| Endpoint | Method | Description |
|---|---|---|
/inbox/create | POST | Create a new inbox, returns {address, token} |
/inbox?token=TOKEN | GET | Check inbox, returns {emails: [...], expired: bool} |
python3 ~/.claude/skills/tempmail/scripts/tempmail.py generate -n 5
# 1. Generate
python3 ~/.claude/skills/tempmail/scripts/tempmail.py generate -n 1
# 2. Use the address for signup (user/agent does this externally)
# 3. Wait, then check inbox
python3 ~/.claude/skills/tempmail/scripts/tempmail.py inbox <address>
# 4. Read the verification email
python3 ~/.claude/skills/tempmail/scripts/tempmail.py read <address> <msg_id>
python3 ~/.claude/skills/tempmail/scripts/tempmail.py check-all