superhuman-mail

Automate email search, draft management, and safe sending in Superhuman.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/tmustier/superhuman-mail --skill superhuman-mail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superhuman-mail
Source: https://github.com/tmustier/superhuman-mail/tree/main
Command: npx skills add https://github.com/tmustier/superhuman-mail --skill superhuman-mail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cryptography, pypdf2, pdf2image, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill eliminates manual processes within Superhuman, enabling users to automate complex email workflows, search for information quickly, manage drafts, and safely send emails.

Core Features & Use Cases

  • Search Threads: Quickly find emails, threads, and messages using powerful search capabilities.
  • Read Receipts/Opens: Inspect per-thread opens and the Recent Opens feed for better tracking.
  • Draft Management: Create, read, discard, and manage drafts efficiently.
  • Send Safety: Use a strict send process with lifecycle validation, attestation, and approval to ensure safe email delivery.
  • Use Case: If you regularly send emails and need to ensure they are sent safely and correctly, this Skill allows you to schedule sends, get read receipts, and manage drafts all within the Superhuman interface.

Quick Start

Set up the 'shm' skill and use the 'shm setup' command to bootstrap configuration. Then, to search for a thread, use 'shm thread search "customer name topic"'. To send a draft, use 'shm send --dry-run <thread_id> <draft_id> --account [email protected]'.

Frequently Asked Questions about superhuman-mail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Superhuman email workflows and draft management?

Automate Superhuman email workflows by using the 'shm' CLI to search threads, manage drafts, and send emails. The tool interfaces directly with Superhuman's private API and local desktop cache to execute commands.

How do I track email opens and read receipts in Superhuman?

Track email opens in Superhuman by using the CLI to inspect per-thread opens and the Recent Opens feed. This provides better visibility into recipient interactions without needing to manually check the interface.

Do I need Python and Node.js to automate email sending in Superhuman?

Yes, automating email sending in Superhuman requires Python, Node.js, and the 'cryptography' package. These dependencies are necessary to interface with the private API and manage local desktop cache securely.

Can I validate email drafts before sending them through Superhuman?

Yes, you can validate email drafts before sending by using the strict send process with lifecycle validation and attestation. The CLI supports a dry-run mode to preview drafts and ensure safe email delivery.

How do I search for specific email threads in Superhuman using the command line?

Search for specific email threads in Superhuman using the command line by running 'shm thread search' followed by your query terms. This leverages the local desktop cache to quickly find matching messages.

What are the limitations of automating Superhuman with a local desktop cache?

Automating Superhuman with a local desktop cache requires the desktop application to be running and properly synced. The automation relies on accessing this local data, meaning offline capabilities are limited by the cache's current state.