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
npx skills add basecamp/skills --skill hey -a claude-codeWhat 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 fromdraft.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-code2Manually: put the files in place
~/.claude/skills/hey/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/hey/
1Skills CLI (Vercel)
npx skills add basecamp/skills --skill hey -a codex2Manually: put the files in place
.agents/skills/hey/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add basecamp/skills --skill hey -a cursor2Manually: put the files in place
.cursor/skills/hey/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install basecamp/skills skills/hey2Manually: put the files in place
.github/skills/hey/SKILL.md1Skills CLI (Vercel)
npx skills add basecamp/skills --skill hey -a gemini-cli2Platform CLI
gemini skills install https://github.com/basecamp/skills --path skills/heyManually: put the files in place
.devin/skills/hey/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add basecamp/skills --skill hey -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.