# Find In Superhuman

Find and read mail in Superhuman, the thread where something was said, sent, or...

- Repository: https://github.com/ParadevAI/Paradev (15823 stars)
- Category: Business
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ParadevAI/Paradev --skill find-in-superhuman -g -a claude-code -y`
Codex: `npx skills add ParadevAI/Paradev --skill find-in-superhuman -g -a codex -y`
Cursor: `npx skills add ParadevAI/Paradev --skill find-in-superhuman -g -a cursor -y`
Gemini CLI: `npx skills add ParadevAI/Paradev --skill find-in-superhuman -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ParadevAI/Paradev`

## Description

Find and read mail in Superhuman, the thread where something was said, sent, or promised, by filtering on who, when, and which split before searching by words, reading the thread before answering, and linking the thread behind every claim. Use when the user asks what someone emailed, whether a reply or an invoice ever arrived, what the latest is on a thread, or what is on their calendar.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Find the thread, then read it

An inbox answer is a thread, not a summary. Narrow to the threads that can hold
the answer, read the ones that do, and tie each claim to the message it came
from.

## 1. Know which account you are reading

`list_accounts` first. Superhuman can link several accounts to one connection,
and every other tool reads the primary one unless `acting_email` says
otherwise. When the question could span accounts (a personal and a work inbox),
run it once per account and say which one each result came from. An empty
result from the wrong account looks exactly like a thread that does not exist.

## 2. Filter on people and time before words

`list_threads` takes `from`, `to`, `subject_contains`, `body_contains`,
`start_date`, `end_date`, `labels`, and `split`. "The invoice from Stripe last
month" is a sender and a date range, not a body search. Address filters match
substrings, so a domain finds everyone at the company. `body_contains` is the
widest net and ranks nothing, so pair it with a sender or a date range rather
than running it alone.

Splits behave differently: `split` reads a precomputed membership list, so it
ignores the date filters, and `sort` reorders only the page you got back. To
walk a split by date, page with `cursor` and compare timestamps yourself.

## 3. Ask the question tool questions, not lookups

`query_email_and_calendar` answers a natural-language question across mail,
calendar, and contacts ("what is still waiting on me from the Acme deal", "what
is on my calendar Thursday"). Use it when the question spans threads or needs
the calendar. Do not use it to fetch a thread you already identified: read that
one with `get_thread`, because a synthesized answer blurs which message said
what.

## 4. Read the thread before answering

The rest: https://github.com/ParadevAI/Paradev/blob/HEAD/plugins/superhuman/skills/find-in-superhuman/SKILL.md