# Social Email > social email - Skill: `isaacrowntree/social-email` (Agent Skill) - Install (CLI): `npx skillmds@latest add isaacrowntree/social-email` - Raw SKILL.md: https://api.skillmd.com/api/skills/isaacrowntree/social-email/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: isaacrowntree (https://skillmd.com/u/isaacrowntree) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/isaacrowntree/social-email --- # social email Email through the himalaya CLI: list, read, search, trace headers, send, reply, move, flag, delete. **Run:** `social email ` (installed via `bun link` in this repo, or `bun run /path/to/claude-social-skills/src/cli.ts email …`). Add `--dry-run` before any command to print the request instead of sending it. ## Credentials - none; auth lives in the underlying tool's own config Nothing to store here: accounts, servers and passwords live in himalaya's TOML config. Run `himalaya account configure` (or bare `himalaya`) to add one, `himalaya account list` to see them. Check what is present with `social auth status email`; store a value with `social auth set email ` (OS keyring, else `~/.config/social/.env`). Docs: https://github.com/pimalaya/himalaya ## API description this wrapper is built from No machine-readable spec: himalaya --help (v2.1.0). ## Commands Every command accepts `--json` (raw JSON) and `--jq ` (filter the JSON with jq). ### `social email accounts` accounts in himalaya's config ### `social email folders` mailboxes (folders) of an account ``` --counts also fetch total/unread per mailbox (one IMAP STATUS each) -a, --account himalaya account (default: the config's default account) ``` ### `social email list` newest envelopes first (* unread, ! flagged, @ attachment) ``` -f, --folder mailbox name or alias (default: inbox) -s, --page-size envelopes per page (himalaya default 25) -p, --page page number from 1 --has-attachment populate the attachment marker (extra lookup per envelope) -a, --account himalaya account (default: the config's default account) ``` ### `social email search ...` search envelopes: `from x and subject y`, `after 2026-01-01`, `flag seen`, `not …`, `order by date desc` ``` -f, --folder mailbox name or alias (default: inbox) -s, --page-size envelopes per page -p, --page page number from 1 -a, --account himalaya account (default: the config's default account) ``` ### `social email read ` read a message (leaves it unread unless --seen) ``` -f, --folder mailbox name or alias (default: inbox) --preview accepted for compatibility: v2 reads never mark seen --seen mark the message seen while reading -H, --headers print only these headers, from the raw message --raw the original RFC 5322 bytes -a, --account himalaya account (default: the config's default account) ``` ### `social email trace ` where a message came from: Received chain, SPF/DKIM/DMARC results, Return-Path, originating IP, mailer ``` -f, --folder mailbox name or alias (default: inbox) -a, --account himalaya account (default: the config's default account) ``` ### `social email attachments ` list a message's attachments; ids feed `himalaya attachment download ` ``` -f, --folder mailbox name or alias (default: inbox) -d, --download [dir] download all to a directory (default: himalaya's downloads-dir) -a, --account himalaya account (default: the config's default account) ``` ### `social email send ` send a message from a JSON spec {to, cc, bcc, subject, body, from, attachments}: a file path, - for stdin, or inline JSON ``` -a, --account himalaya account (default: the config's default account) ``` ### `social email reply ` reply to a message; recipients come from Reply-To/From unless --to is given ``` -f, --folder mailbox of the source (default: inbox) -b, --body reply text (stdin if omitted) -t, --to override recipients --cc --bcc --attach --bottom quote the original above your text -a, --account himalaya account (default: the config's default account) ``` ### `social email forward ` forward a message (himalaya adds no recipient itself, so --to is required) ``` -t, --to recipient(s) (required) -f, --folder mailbox of the source (default: inbox) -b, --body note above the forwarded text (default "") --cc --bcc --attach -a, --account himalaya account (default: the config's default account) ``` ### `social email move ` move a message to another mailbox ``` -f, --folder source mailbox (default: inbox) -a, --account himalaya account (default: the config's default account) ``` ### `social email flag ` add or remove flags: seen, answered, flagged, draft ``` --add --remove -f, --folder mailbox name or alias (default: inbox) -a, --account himalaya account (default: the config's default account) ``` ### `social email delete ` delete a message (moves to trash; permanent if already in trash) ``` -f, --folder mailbox name or alias (default: inbox) -a, --account himalaya account (default: the config's default account) ``` ## Anything else: the escape hatch ```bash social api email # GET, path relative to the API root social api email -q key=value # query parameters social api email -f key=value # JSON body field (typed: numbers, booleans, null, JSON literals); implies POST social api email --raw-field key=value # string field social api email -X DELETE social api email --input body.json # or --input - for stdin social api email --form # urlencoded body instead of JSON social api email --jq '.data[0].id' ``` Reach for `social api email …` before concluding something is unsupported. ## Behaviour - Retries 502/503/504 on idempotent methods (3 attempts, 250 ms then 1 s); waits once on 429 up to 90 s. - Errors print `HTTP ` and the response body, exit code 1. - `--dry-run` prints the method, URL and body of any mutating call and sends nothing. - `social doctor` makes one cheap authenticated read per configured platform.