- 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 <skill-dir>/scripts/dropmail.py /usr/local/bin/dropmail
# User-local
ln -s <skill-dir>/scripts/dropmail.py ~/.local/bin/dropmailData 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 <email> inbox # Show all messages in inbox
dropmail <email> inbox -c 3 # Show last 3 messages only
dropmail <email> refresh # Fetch new messages from GuerrillaMail API
dropmail <email> read <id> # Read full body of a message
dropmail <email> remove # Remove email + all messages from local DB
dropmail <email> expire # Show time remaining before expiryTypical Workflow
dropmail new— get a fresh email- Share the email address with the untrusted service
dropmail <email> refresh- pull new messages from the serverdropmail <email> inbox- browse received messagesdropmail <email> read <id>- read a specific messagedropmail <email> 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.
inboxreads from cache;refreshsyncs from server. - 403 errors: GuerrillaMail blocks non-browser User-Agents. The script uses
Mozilla/5.0by default. If blocked, checkreferences/api.md. - Expiry: Emails last 60 minutes. After expiry, old messages are still accessible by calling
set_email_userviarefresh.
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