How do I install the Hey Email skill?

Run npx skillmds@latest add psacc/hey-email in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Hey Email safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hey Email?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hey Email free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Hey Email?

psacc (@psacc) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hey Email by psacc — Agent Skill

Name: Hey Email
Rating: 4.2 (5 reviews)
Author: psacc

Hey Email

Interact with Hey.com email. Use when the user mentions email, inbox, checking mail, reading email, searching email, screening, reply later, set aside, or Hey.com. Trigger phrases: "check my email", "what's in my inbox", "read email", "search email", "show my feed", "what's screened out", "screen this sender", "reply later", "set aside", "mark as read", "approve sender", "reject sender", "hey inbox".

psacc bbe133e 3.0 KB Updated Sep 17, 2026

File contents

You have access to the hey-cli tool for interacting with Hey.com email.

Commands

Run commands from the hey-cli directory using Bash with node hey.js.

Read commands

Command	What it does
`hey.js inbox --json`	List Imbox emails
`hey.js read <topic-id> --json`	Read a specific email thread
`hey.js search <query> --json`	Search emails
`hey.js feed --json`	List The Feed
`hey.js screened --json`	List Screened Out emails
`hey.js reply-later --json`	List Reply Later queue
`hey.js set-aside --json`	List Set Aside pile
`hey.js screen --json`	List senders pending screening

Action commands

Command	What it does
`hey.js mark-read <topic-id> --json`	Mark email as read
`hey.js screen approve <email> --json`	Approve a screened sender
`hey.js screen reject <email> --json`	Reject a screened sender
`hey.js reply-later add <topic-id> --json`	Add to Reply Later
`hey.js reply-later remove <topic-id> --json`	Remove from Reply Later
`hey.js set-aside add <topic-id> --json`	Add to Set Aside
`hey.js set-aside remove <topic-id> --json`	Remove from Set Aside

Always use the --json flag for structured output.

How to present results

Inbox/Feed/Screened/Reply Later/Set Aside (JSON array of email objects):

Show as a concise list: unread marker, subject, time
Mention total count and how many are unread
Use topic IDs when referencing emails so the user can ask to read one

Screen (JSON array of sender objects):

Show sender name, email, and preview
Ask the user if they want to approve or reject each sender

Read (JSON with ariaSnapshot field):

Extract sender, subject, and body from the aria snapshot
Present the email content in a readable format, not raw aria text

Search (JSON with ariaSnapshot field):

Extract and list matching results from the aria snapshot
Show subject and sender for each match

Action results (JSON with action, success fields):

Confirm the action was performed successfully
If failed, show the error message

Error handling

If a command fails or returns what looks like a login page instead of email data, tell the user their Hey session may have expired and suggest running:

node hey.js login

This opens a browser for manual login. The session persists across invocations.

Important

Commands take 3-5 seconds (browser startup). This is normal.
Topic IDs are numeric (e.g., 1951316335).
Screening uses sender email addresses, not topic IDs.
Set a timeout of at least 30 seconds for commands.

---name: hey-emaildescription: Interact with Hey.com email. Use when the user mentions email, inbox, checking mail, reading email, searching email, screening, reply later, set aside, or Hey.com. Trigger phrases: "check my email", "what's in my inbox", "read email", "search email", "show my feed", "what's screened out", "screen this sender", "reply later", "set aside", "mark as read", "approve sender", "reject sender", "hey inbox".license: MIT---You have access to the `hey-cli` tool for interacting with Hey.com email.## CommandsRun commands from the hey-cli directory using Bash with `node hey.js`.### Read commands| Command | What it does ||---------|-------------|| `hey.js inbox --json` | List Imbox emails || `hey.js read <topic-id> --json` | Read a specific email thread || `hey.js search <query> --json` | Search emails || `hey.js feed --json` | List The Feed || `hey.js screened --json` | List Screened Out emails || `hey.js reply-later --json` | List Reply Later queue || `hey.js set-aside --json` | List Set Aside pile || `hey.js screen --json` | List senders pending screening |### Action commands| Command | What it does ||---------|-------------|| `hey.js mark-read <topic-id> --json` | Mark email as read || `hey.js screen approve <email> --json` | Approve a screened sender || `hey.js screen reject <email> --json` | Reject a screened sender || `hey.js reply-later add <topic-id> --json` | Add to Reply Later || `hey.js reply-later remove <topic-id> --json` | Remove from Reply Later || `hey.js set-aside add <topic-id> --json` | Add to Set Aside || `hey.js set-aside remove <topic-id> --json` | Remove from Set Aside |Always use the `--json` flag for structured output.## How to present results**Inbox/Feed/Screened/Reply Later/Set Aside** (JSON array of email objects):- Show as a concise list: unread marker, subject, time- Mention total count and how many are unread- Use topic IDs when referencing emails so the user can ask to read one**Screen** (JSON array of sender objects):- Show sender name, email, and preview- Ask the user if they want to approve or reject each sender**Read** (JSON with ariaSnapshot field):- Extract sender, subject, and body from the aria snapshot- Present the email content in a readable format, not raw aria text**Search** (JSON with ariaSnapshot field):- Extract and list matching results from the aria snapshot- Show subject and sender for each match**Action results** (JSON with action, success fields):- Confirm the action was performed successfully- If failed, show the error message## Error handlingIf a command fails or returns what looks like a login page instead of email data,tell the user their Hey session may have expired and suggest running:```node hey.js login```This opens a browser for manual login. The session persists across invocations.## Important- Commands take 3-5 seconds (browser startup). This is normal.- Topic IDs are numeric (e.g., 1951316335).- Screening uses sender email addresses, not topic IDs.- Set a timeout of at least 30 seconds for commands.

Frequently asked questions