Mailbox

---
name: Mailbox CLI (OpenClaw Skill)
description: 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.
---

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