himalaya — Claude skill: IMAP/SMTP mail from the shell
A skill that shows the agent how to drive the himalaya CLI: list, read, search, compose, reply and file mail without leaving the session.
npx skills add openclaw/openclaw --skill himalaya -a claude-codeWhat himalaya does
The skill documents shell calls to himalaya: folder list, envelope list, reading a message by id, searching by sender and subject. Sending and replying get their own sections.
Two references ship with it. references/configuration.md covers account config, auth and backend setup; references/message-composition.md explains MML syntax for attachments. Config lives at ~/.config/himalaya/config.toml and himalaya account configure walks you through the account. Credentials belong in a password manager or keyring, not pasted into chat.
The himalaya binary has to be on your machine, otherwise nothing runs. If you read mail in a web client and have no plans to script your inbox, skip it.
What it helps with
- read a message by id from inside the session
- find every message from one sender on a given subject
- send a template stored in a file
- reply to a message and forward another
- move messages between folders and clear the seen flag
Example prompts for the agent
- list the folders in my mailbox with himalaya
- find messages from [email protected] with invoice in the subject
- send the template from /tmp/message.txt
How to install himalaya
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill himalaya -a claude-code2Manually: put the files in place
~/.claude/skills/himalaya/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/himalaya/
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill himalaya -a codex2Manually: put the files in place
.agents/skills/himalaya/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill himalaya -a cursor2Manually: put the files in place
.cursor/skills/himalaya/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openclaw/openclaw himalaya2Manually: put the files in place
.github/skills/himalaya/SKILL.md1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill himalaya -a gemini-cli2Platform CLI
gemini skills install https://github.com/openclaw/openclaw --path skills/himalayaManually: put the files in place
.devin/skills/himalaya/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill himalaya -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set45
The whole set →Similar
Questions about himalaya
How do I install himalaya in Claude?
Run npx skills add openclaw/openclaw --skill himalaya -a claude-code; the file lands at ~/.claude/skills/himalaya/SKILL.md. The CLI itself is separate: brew install himalaya.
What does the himalaya skill do?
It tells the agent how to handle mail through the CLI: folders and envelopes, reading, searching, composing, replying, forwarding, copying and deleting.
What do I need before it works?
The himalaya binary plus a configured account in ~/.config/himalaya/config.toml. Keep credentials in a password manager or keyring.
Source text
SKILL.md · MIT
---
name: himalaya
description: "Himalaya CLI for IMAP/SMTP mail: list, read, search, compose, reply, forward, copy, move, delete."
homepage: https://github.com/pimalaya/himalaya
metadata:
{
"openclaw":
{
"emoji": "📧",
"requires": { "bins": ["himalaya"] },
"install":
[
{
"id": "brew",
"kind": "brew",
"formula": "himalaya",
"bins": ["himalaya"],
"label": "Install Himalaya (brew)",
},
],
},
}
---
# Himalaya
Use `himalaya` for IMAP/SMTP email from shell.
## References
- `references/configuration.md`: account config, auth, backend setup.
- `references/message-composition.md`: MML compose syntax.
## Setup
```bash
himalaya --version
himalaya account configure
```
Config path: `~/.config/himalaya/config.toml`.
Prefer password managers/keyrings for credentials; do not paste secrets into chat/logs.
## Read/search
```bash
himalaya folder list
himalaya envelope list
himalaya message read <id>
himalaya envelope list from [email protected] subject invoice
```
## Write
```bash
himalaya message write
himalaya template write
himalaya template send < /tmp/message.txt
himalaya message reply <id>
himalaya message forward <id>
```
Use MML for attachments and rich messages; read `references/message-composition.md` first.
## Organize
```bash
himalaya message copy <id> --to <folder>
himalaya message move <id> --to <folder>
himalaya message delete <id>
himalaya flag add <id> --flag seen
himalaya flag remove <id> --flag seen
```
## Notes
- Use `--account` when multiple accounts exist.
- Quote exact message IDs in summaries.
© openclaw · MIT · openclaw/openclaw