# 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.

- Skill: `modbender/mailbox-cli-openclaw-skill` (Agent Skill)
- Install (CLI): `npx skillmds@latest add modbender/mailbox-cli-openclaw-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/mailbox-cli-openclaw-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/mailbox-cli-openclaw-skill

---


# 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 --json`
- `mailbox email list --limit 20 --json`
- `mailbox email show <email_uid> --account-id <account_id> --json`
- `mailbox email show <email_uid> --account-id <account_id> --preview --no-html --json`
- `mailbox email show <email_uid> --account-id <account_id> --preview --no-html --strip-urls --json`
- `mailbox email delete <email_uid> --account-id <account_id> --folder INBOX --confirm --json`
- `mailbox digest run --json`
- `mailbox monitor run --json`
- `mailbox inbox --limit 15 --text`

## Safety rules
- Always use `--json` for automation and check `success`.
- Include `--account-id` for destructive operations.
- Destructive operations default to dry-run unless `--confirm` is provided.
- Prefer `--dry-run` before mutating when available.

## Output contract
- JSON response includes `success` and `error` fields.
- `error` is an object with `{ code, message, detail? }`.
- Exit codes: 0 success, 1 operation failed, 2 invalid usage.