Back to Communication & Collaboration

Himalaya Mail CLI

emailcliautomationimapsmtp
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