Back to Skills

himalaya

Himalaya CLI for IMAP/SMTP mail: list, read, search, compose, reply, forward, copy, move, delete.

375,117stars78,220forksUpdated 5/28/2026

Security Assessment

Safe(100/100)
Security Score100/100

About himalaya

Himalaya is a command-line interface (CLI) tool designed for managing emails via IMAP and SMTP protocols directly from the terminal. It addresses the need for a lightweight, scriptable solution for users who prefer shell-based workflows over traditional graphical email clients. By providing a range of commands to interact with email accounts, Himalaya streamlines tasks like reading, composing, searching, and organizing messages without leaving the command-line environment. This makes it especially useful for developers, system administrators, and power users who often operate in terminal-based environments or automate email-related tasks.

FAQ

How do I configure my email account in Himalaya?

You can configure an account by running `himalaya account configure`. Configuration files are stored at `~/.config/himalaya/config.toml`. It's recommended to use password managers or keyrings for credentials rather than pasting secrets directly into logs or chat.

Which operating systems or environments does Himalaya support?

Himalaya requires the CLI binary to be installed, for example via Homebrew on macOS. It operates in any environment where the `himalaya` binary can run and has access to IMAP/SMTP services. Specific OS compatibility is determined by the availability of the binary in package managers.

Can I send attachments or rich-text messages?

Yes, Himalaya supports composing messages with attachments and rich formatting using MML (Message Markup Language). Users should refer to `references/message-composition.md` for syntax and examples.

How can I avoid affecting multiple messages accidentally?

Always confirm actions before sending, deleting, or moving many messages. When managing multiple accounts, use the `--account` flag to specify the intended account, and ensure message IDs are quoted exactly in commands.

Are there any limitations regarding search or message organization?

Himalaya supports searching by sender, subject, and other criteria, but the effectiveness may depend on the backend IMAP server. Organizing messages involves copy, move, delete, and flag operations, all of which require specifying message IDs explicitly.

All Files

3 files
references/message-composition.md3.7 KB
View
SKILL.md1.7 KB
View
references/configuration.md4.0 KB
View

Install himalaya

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill