Agent & workflow ready
JSON output, deterministic exit codes, and a raw hscli api hatch let agents and pipelines drive Help Scout directly.
Open source · Help Scout CLI Help Scout,
Help Scout,
from your terminal.
A fast, scriptable CLI for Help Scout — built for terminals, CI pipelines, and AI agents like Claude Code and Codex. Every command speaks JSON and returns clean exit codes.
$npm i -g @wavyx/hscli
$ hscli conv list --status active --output table
ID SUBJECT CUSTOMER STATUS
4831 Refund for order #2207 amir@acme.io active
4830 Can't reset my password lou@hey.com active
4827 Invoice question kai@studio.co active
$ # close everything tagged "resolved"
$ hscli conv bulk-status --status active --tag resolved \
--set closed --yes
✓ 12 conversations closed · exit 0
Why hscli
Built for automation, not clicking.
Four design decisions that make hscli safe to hand to a script — or an agent.
Pipe-friendly output
Every command supports --output table|json|yaml|csv, plus --jq and --fields for inline filtering and projection.
Secure by default
OAuth tokens live only in your OS keychain — never written to disk in plaintext. hscli api is locked to the Help Scout host.
Full account backups
hscli backup dumps your whole account to JSON with incremental refresh, resume, deletion detection, and attachments.
What you can actually do
Real work, one line at a time.
hscli composes with the tools you already use — jq, xargs, cron, and your CI runner.
Triage
Let an agent clear the queue
Pipe active conversations into your model and act on its decisions — no integration code.
$ hscli conv list --status active \
--output json --fields id,subject \
| claude -p "tag & assign each"
Backup
Nightly account snapshot in CI
Incremental by default, resumable, and deletion-aware. Drop it in a cron job or a GitHub Action.
# .github/workflows/backup.yml
$ hscli backup --out ./hs-data \
--attachments --compress
✓ 4,210 convs · 38 MB · exit 0
Report
Pull metrics into a spreadsheet
Stream any report as CSV and pipe it straight into your BI tool or a Google Sheet.
$ hscli report conversations \
--start 2026-05-01 --end 2026-05-31 \
--output csv > may.csv
Drive Help Scout from anywhere.
Install once. Script everything. Hand the rest to an agent.