modbender Mailbox CLI (OpenClaw Skill)
Use the mailbox CLI as a tool to read and manage email. OpenClaw handles channel delivery and scheduling. The mailbox CLI returns structured JSON outputs and optional text summaries.
Requirements
- mailbox CLI installed (
npm install -g mailbox-cli) - Credentials in
~/.config/mailbox/auth.json
Commands (examples)
mailbox account list --jsonmailbox email list --limit 20 --jsonmailbox email show <email_uid> --account-id <account_id> --jsonmailbox email show <email_uid> --account-id <account_id> --preview --no-html --jsonmailbox email show <email_uid> --account-id <account_id> --preview --no-html --strip-urls --jsonmailbox email delete <email_uid> --account-id <account_id> --folder INBOX --confirm --jsonmailbox digest run --jsonmailbox monitor run --jsonmailbox inbox --limit 15 --text
Safety rules
- Always use
--jsonfor automation and checksuccess. - Include
--account-idfor destructive operations. - Destructive operations default to dry-run unless
--confirmis provided. - Prefer
--dry-runbefore mutating when available.
Output contract
- JSON response includes
successanderrorfields. erroris an object with{ code, message, detail? }.- Exit codes: 0 success, 1 operation failed, 2 invalid usage.