Back to skills
shellmail
by aaronbatchelder
Browser & Automation—Not yet rated
Your rating
Brief
Email API for AI agents.
Description
What This Skill Does
ShellMail gives AI agents a real email inbox at shellmail.ai. Agents can check for new messages, read full emails, and extract OTP codes automatically via a REST API and shell scripts.
Agents get a real, dedicated inbox without configuring IMAP, SMTP, or a full email provider.
When to Use It
- Receiving verification emails during automated account signup
- Extracting OTP codes from two-factor authentication flows
- Waiting for a password reset link in automated test scripts
- Searching inbox for emails from a specific sender domain
- Archiving processed emails after extracting needed data
Example Workflow
INPUT
User asks: get the GitHub verification code
AGENT
- 1
Run otp command with --wait 30 and --from github.com flags
- 2
Poll the ShellMail API for up to 30 seconds
- 3
Extract the OTP code from the matching email
- 4
Return the code to the user
OUTPUT
Six-digit OTP code extracted from the GitHub verification email
Requirements
- SHELLMAIL_TOKEN: Bearer token from shellmail.ai (required)
- SHELLMAIL_API_URL: API base URL, only needed for self-hosted instances (optional)
Installation
clawhub install aaronbatchelder/shellmailRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.