Skip to main content
skill CX Codex

hey — Claude Code skill: HEY email and tasks from the agent

The skill connects the HEY CLI to the agent. Read mail, send replies, manage contacts, calendar, todos, time tracking and journal entries from the agent.

no license 263 installs ★ 88 updated 2026-11-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add basecamp/skills --skill hey -a claude-code
Open on GitHub

What hey does

The skill wires the HEY CLI and lets the agent manage mailboxes, labels, collections, contacts, calendars, todo lists, time tracking and journal entries. The agent reads threads by id or topic_id, sends messages and drafts, moves threads between boxes, filters senders via the screener, and shares threads with public links.

You need the hey CLI installed and authorised via hey auth login. The skill uses stored credentials and refreshes tokens itself. If multiple HEY accounts are linked, commands accept --account <id|all>. Structured output goes through --json and --jq; HTML versions of messages and journal entries are printed via --html to a file or pipe only.

A send that fails with not_delivered is not retried: this prevents duplicates. Box mutation commands require explicit ID confirmation because HEY does not report when a given ID was not found.

What it helps with

  • read and send HEY mail from the agent
  • filter senders and manage the screener queue
  • create public share links for threads
  • sync calendar, todos and time tracking
  • move threads between boxes and apply labels

Example prompts for the agent

  • Show unread messages in the Imbox
  • Send a message to [email protected] with subject "Quarterly sync" and body from draft.txt
  • Find all mail from [email protected] in the last month and move it to the Projects box

How to install hey

1Skills CLI (Vercel)

npx skills add basecamp/skills --skill hey -a claude-code

2Manually: put the files in place

~/.claude/skills/hey/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/hey/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about hey

How to install hey in Claude Code?

Run npx skills add basecamp/skills --skill hey -a claude-code, then check that ~/.claude/skills/hey/SKILL.md was created.

What does the hey skill do?

Connects the HEY CLI to the agent: read mail, send messages, manage contacts, calendar, todos and time tracking. Commands invoke hey with the right flags and filter output via --jq.

What does hey require to work?

The hey CLI installed and authorised via hey auth login. The skill uses stored credentials and refreshes tokens itself; the agent does not run explicit login.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set3

Project sponsors

Companies that keep this analytics open