DropMail – disposable email manager

---

name: dropmail description: Manage disposable email addresses using GuerrillaMail. Use when a user wants to create a temporary/throwaway email address, check a disposable inbox for messages, or avoid sharing their real email with untrusted services. Triggers on phrases like "temp email", "disposable email", "temporary email", "throwaway email", "create a burner email", or any dropmail command.

---

DropMail Skill

Create and manage disposable email addresses via GuerrillaMail API. Emails expire after 60 minutes. All data is stored locally in SQLite at ~/.dropmail/dropmail.db.

Installation

Create a symlink to dropmail.py on your PATH:

# System-wide
ln -s /scripts/dropmail.py /usr/local/bin/dropmail
User-local
ln -s /scripts/dropmail.py ~/.local/bin/dropmail

Data is stored at ~/.dropmail/ (auto-created on first run). Requires Python 3.7+, no extra dependencies.

Commands

dropmail new                            # Get a new disposable email
dropmail list                           # List all tracked emails with expiry status
dropmail  inbox                  # Show all messages in inbox
dropmail  inbox -c 3             # Show last 3 messages only
dropmail  refresh                # Fetch new messages from GuerrillaMail API
dropmail  read               # Read full body of a message
dropmail  remove                 # Remove email + all messages from local DB
dropmail  expire                 # Show time remaining before expiry

Typical Workflow

1. dropmail new — get a fresh email 2. Share the email address with the untrusted service 3. dropmail refresh - pull new messages from the server 4. dropmail inbox - browse received messages 5. dropmail read - read a specific message 6. dropmail remove - clean up when done

Notes

Data location: All data stored in ~/.dropmail/ (DB + sessions). Auto-created on first run.

Sessions: Per-email PHPSESSID cookies stored in ~/.dropmail/sessions.json. Expire after ~18 min of API inactivity.

Offline inbox: Messages are cached locally. inbox reads from cache; refresh syncs from server.

403 errors: GuerrillaMail blocks non-browser User-Agents. The script uses Mozilla/5.0 by default. If blocked, check references/api.md.

Expiry: Emails last 60 minutes. After expiry, old messages are still accessible by calling set_email_user via refresh.

API Reference

For full GuerrillaMail API details, see references/api.md. Load it when:

Debugging API call failures

Adding new API features (extend, delete messages, forget)

Understanding session/cookie handling

Data location: All data stored in ~/.dropmail/ (DB + sessions). Auto-created on first run.

Sessions: Per-email PHPSESSID cookies stored in ~/.dropmail/sessions.json. Expire after ~18 min of API inactivity.

Offline inbox: Messages are cached locally. inbox reads from cache; refresh syncs from server.

403 errors: GuerrillaMail blocks non-browser User-Agents. The script uses Mozilla/5.0 by default. If blocked, check references/api.md.

Expiry: Emails last 60 minutes. After expiry, old messages are still accessible by calling set_email_user via refresh.