Back to Communication & Collaboration

Himalaya Mail CLI

emailcliautomationimapsmtp
β˜… 4.5 (226)⭐ 379.0kπŸ“„ NOASSERTIONπŸ•’ 2026-06-16Source β†—

Install this skill

npx skills add openclaw/openclaw

Works across Claude Code, Cursor, Codex, Copilot & Antigravity

What this skill does

  • β€’Send and receive email via IMAP/SMTP from the terminal
  • β€’Perform advanced searches across folders and message metadata
  • β€’Compose rich messages using MML syntax for attachments
  • β€’Execute folder operations like moving, copying, and deleting emails
  • β€’Manage flag states like seen or unseen status programmatically

When to use it

  • βœ“When you need to automate email alerts or notifications from a terminal
  • βœ“When you want to search through your inbox without leaving your IDE
  • βœ“When you need to script a reply or forward workflow for specific tickets
  • βœ“When you prefer a lightweight, keyboard-driven alternative to web clients

When not to use it

  • βœ•When you require a GUI for viewing complex HTML-heavy newsletters
  • βœ•When you need to manage multiple high-traffic corporate inboxes simultaneously

How to invoke it

Example prompts that trigger this skill:

  • β€œList all messages in my primary inbox using Himalaya.”
  • β€œSearch for the latest invoice emails from [email protected].”
  • β€œReply to message ID 42 with a confirmation notice.”
  • β€œMove the email with ID 105 to the Archive folder.”
  • β€œRead the content of the most recent message in my inbox.”

Example workflow

  1. Run 'himalaya account configure' to link your IMAP/SMTP credentials.
  2. Execute 'himalaya envelope list' to view the inbox message IDs.
  3. Run 'himalaya message read <id>' to inspect a specific email content.
  4. Draft a reply using 'himalaya message reply <id>'.
  5. Send the drafted message through the configured SMTP provider.

Prerequisites

  • –Active IMAP/SMTP email account credentials
  • –System keyring or password manager for secure secret storage

Pitfalls & limitations

  • !Commands can inadvertently execute shell-level actions, so always verify IDs before mass deletions.
  • !MML syntax requires familiarity to correctly format complex attachments.
  • !Requires manual configuration of TOML files which can be brittle if credentials change.

FAQ

How do I secure my email credentials?
Always use a system keyring or password manager. Do not store plain-text passwords in your configuration files.
Can I manage multiple email accounts?
Yes, use the --account flag to specify which account configuration to target for any given command.
Does it support attachments?
Yes, it uses MML syntax for composition; consult the reference documentation for specific attachment tagging rules.
Is the configuration file portable?
The configuration is stored in ~/.config/himalaya/config.toml, making it easy to back up or version control your settings.

How it compares

Himalaya replaces manual web-interface clicking with precise, scriptable CLI commands, turning email management into a standard command-line utility workflow.

Source & trust

⭐ 379k starsπŸ“„ NOASSERTIONπŸ•’ Updated 2026-06-16πŸ›‘ runs-shell, network, reads-credentials

From the source: β€œ# 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…”

View the full SKILL.md source

# 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> <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.

Quoted from openclaw/openclaw for reference β€” see the original for the authoritative, latest version.

πŸ“„ Full skill instructions β€” original source: openclaw/openclaw
Himalaya provides a terminal-based interface for managing IMAP and SMTP email accounts directly from the command line. Unlike web-based clients or heavy GUI applications, Himalaya integrates email tasks like reading, searching, and sending messages into your development environment. By using a configuration-driven approach, it allows developers to script email interactions and organize inboxes through standard shell commands. It is particularly effective for users who prefer working in a terminal session and wish to keep email operations local. The tool handles message composition via MML syntax, supports flag management, and allows for folder-level operations like moving or deleting messages. It avoids the need for a browser or separate app, keeping your technical workflow focused and centered around your code editor and shell.

How to Use This Skill Unit

Option A: Project-Specific (Recommended)

  1. Click "Download" above
  2. In your project, create the directory: .agent/skills/himalaya/
  3. Save the file as SKILL.md
  4. The agent will automatically discover the skill based on its description.

Option B: Global Installation (All Agents)

Save the file to these locations to make it available across all projects:

  • Claude Code: ~/.claude/skills/openclaw/openclaw/himalaya/SKILL.md
  • Cursor: ~/.cursor/skills/openclaw/openclaw/himalaya/SKILL.md
  • Antigravity: ~/.gemini/antigravity/skills/openclaw/openclaw/himalaya/SKILL.md

πŸš€ Install with CLI:
npx skills add openclaw/openclaw

Read the Master Guide: Mastering Agent Skills β†’

Recommended Rules

View more rules β†’

Recommended Workflows

View more workflows β†’

Recommended MCP Servers

View more MCP servers β†’

Take It Further

Maximize your productivity with these powerful resources

πŸ“‹

Define Your Standards

Set up coding standards to ensure this workflow produces consistent, high-quality results.

Browse Rules Library
πŸ“–

Master Workflows

Learn how to create custom workflows, use Turbo Mode, and build your automation library.

Complete Guide

How to use this Skill in Claude Code & Cursor

For Claude Code (CLI)

To use this skill in Claude Code, copy the rule content into your project's custom instructions or follow our Add-Skill CLI guide. This ensures Claude follows your standards during every code generation.

For Cursor & Windsurf

For Cursor or Windsurf, individual skills are best used in the "Rules for AI" section. This specific unit helps the agent avoid communication & collaboration issues, leading to cleaner, more efficient code.

Why the skill format matters: the standardized Agent Skills format lets your AI agent load detailed instructions only when they are relevant, keeping your prompt clean while improving results.

Source & attribution

This skill is categorized under Communication & Collaboration and is published by openclaw, maintained in openclaw/openclaw.

← Browse All Agent Skills
Sponsored AI assistant. Recommendations may be paid.