A command-line interface for managing emails via IMAP/SMTP, supporting multi-account setups and MML composition.

Install

mkdir -p .claude/skills/himalaya && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/518" && unzip -o skill.zip -d .claude/skills/himalaya && rm skill.zip

Installs to .claude/skills/himalaya

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Himalaya CLI for IMAP/SMTP mail: list, read, search, compose, reply, forward, copy, move, delete.
97 charsno explicit “when” trigger
Intermediate

Key capabilities

  • List and read email messages
  • Compose and send emails using MML
  • Reply to and forward messages
  • Organize emails into folders
  • Search email envelopes
  • Manage message flags

How it works

It interfaces with IMAP and SMTP servers via the command line to perform mail operations. It uses a local configuration file to manage account settings and supports MML for rich message composition.

Inputs & outputs

You give it
Email account credentials and message content
You get back
Sent emails or retrieved message data

When to use himalaya

  • Reading and responding to emails in the terminal
  • Managing multiple email accounts from one CLI
  • Automating email sorting into custom folders
  • Composing rich emails using MML syntax

About this skill

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

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

himalaya folder list
himalaya envelope list
himalaya message read <id>
himalaya envelope list from [email protected] subject invoice

Write

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

himalaya message copy <id> <folder>
himalaya message move <id> <folder>
himalaya message delete <id>
himalaya flag add <id> --flag seen
himalaya flag remove <id> --flag seen

Safety

  • Confirm before sending, deleting, or moving many messages.
  • Use --account when multiple accounts exist.
  • Quote exact message IDs in summaries.

When not to use it

  • When handling sensitive credentials without a password manager
  • When automating high-volume mailings without confirmation

Prerequisites

himalaya CLI installedIMAP/SMTP account configuration

Limitations

  • Requires manual confirmation for bulk operations to prevent errors
  • Configuration must be managed securely outside of logs
  • Requires specific MML syntax knowledge for attachments

How it compares

It enables full email management directly from the terminal, avoiding the need for a graphical mail client.

Compared to similar skills

himalaya side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
himalaya (this skill)502moReviewIntermediate
officeemail-management88moNo flagsIntermediate
gmail166moReviewBeginner
sendgrid-automation14moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry