| name | shellmail |
| description | Email API for AI agents. Check inbox, read emails, extract OTP codes, search messages via ShellMail. Trigger on "check email", "inbox", "otp", "verification code", "shellmail", or any email-related requests. |
| homepage | https://shellmail.ai |
| source | https://github.com/aaronbatchelder/shellmail |
| env | {"SHELLMAIL_TOKEN":{"required":true,"sensitive":true,"description":"Bearer token for ShellMail API authentication (grants access to inbox and OTPs)"},"SHELLMAIL_API_URL":{"required":false,"default":"https://shellmail.ai","description":"API base URL (only change for self-hosted instances)"}} |
ShellMail
Email for AI agents via shellmail.ai. Create inboxes, receive mail, extract OTPs automatically.
First-Time Setup
If no token is configured:
- Ask user for desired email name (e.g., "atlas") and a recovery email
- Or use
auto for the name to generate a random address (e.g., "swift-reef-4821")
- Run:
{baseDir}/scripts/shellmail.sh create <name> <recovery_email>
- If the address is already taken:
- Suggest a different name or use
auto
- Do NOT suggest recovery unless the user confirms it's their previous inbox