What it does. CLI for HEY: mailboxes, labels, collections, email threads, contacts, replies, compose, calendars, todos, habits, time tracking, and journal entries.
- Choose the right structured output — use
--jq ''
to filter or extract fields and --json
for the full response. Never pipe to an external jq
; --jq
is built in and implies --json
. 2. Reuse stored authentication — run the requested data command; it uses stored credentials and refreshes expiring OAuth tokens automatically. If it returns an auth error, report the task as blocked. Use hey auth status --json
when an explicit authentication check is needed. Never run hey auth login
unattended; use it only for interactive recovery with the user present. 3. HTML output is available via --html
for commands that return HTML content 4. Linked mail accounts share one login — use hey account list --json
, then --account
when a task must target one account 5. Local HEY configuration requires human trust — never run hey config trust-local
without the user's explicit approval
When to use it. Interact with HEY email through the HEY CLI: read and send email, manage contacts, boxes and threads without leaving the terminal.
Install
npx skills add basecamp/hey-cli --skill hey
Or copy the skill folder manually:
git clone https://github.com/basecamp/hey-cli.git
cp -r hey-cli/skills/hey/ ~/.claude/skills/hey
Source: basecamp/hey-cli — 257 stars, MIT, last pushed 2026-09-02.
