LaunchKit · 2026
Back to Skills

shellmail

Email API for AI agents.

0
422 downloads
by @aaronbatchelder

Setup & Installation

openclaw skills install @aaronbatchelder/shellmail

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install shellmail

Version History

v1.0.12Mar 12, 2026 - Version note by skill developer:

- Added version field to SKILL.md (now version 1.2.2). - Introduced a metadata block specifying requirements for openclaw, including required environment variables and binaries. - No functional or user-facing changes detected to documentation or usage instructions.

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

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: get the GitHub verification code

AGENT
  1. 1Run otp command with --wait 30 and --from github.com flags
  2. 2Poll the ShellMail API for up to 30 seconds
  3. 3Extract the OTP code from the matching email
  4. 4Return the code to the user
OUTPUT

Six-digit OTP code extracted from the GitHub verification email

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

SHELLMAIL_TOKEN: Bearer token from shellmail.ai (required)SHELLMAIL_API_URL: API base URL, only needed for self-hosted instances (optional)