/install dropmail
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 \x3Cskill-dir>/scripts/dropmail.py /usr/local/bin/dropmail
# User-local
ln -s \x3Cskill-dir>/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 \x3Cemail> inbox # Show all messages in inbox
dropmail \x3Cemail> inbox -c 3 # Show last 3 messages only
dropmail \x3Cemail> refresh # Fetch new messages from GuerrillaMail API
dropmail \x3Cemail> read \x3Cid> # Read full body of a message
dropmail \x3Cemail> remove # Remove email + all messages from local DB
dropmail \x3Cemail> expire # Show time remaining before expiry
Typical Workflow
dropmail new— get a fresh email- Share the email address with the untrusted service
dropmail \x3Cemail> refresh- pull new messages from the serverdropmail \x3Cemail> inbox- browse received messagesdropmail \x3Cemail> read \x3Cid>- read a specific messagedropmail \x3Cemail> 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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install dropmail - After installation, invoke the skill by name or use
/dropmail - Provide required inputs per the skill's parameter spec and get structured output
What is DropMail – disposable email manager?
Manage disposable email addresses using GuerrillaMail. Use when a user wants to create a temporary/throwaway email address, check a disposable inbox for mess... It is an AI Agent Skill for Claude Code / OpenClaw, with 102 downloads so far.
How do I install DropMail – disposable email manager?
Run "/install dropmail" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is DropMail – disposable email manager free?
Yes, DropMail – disposable email manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does DropMail – disposable email manager support?
DropMail – disposable email manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created DropMail – disposable email manager?
It is built and maintained by Nikolay (@cprite); the current version is v1.0.1.