himalayaCLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Install via ClawdBot CLI:
clawdbot install lamelas/himalayaInstall Himalaya (brew):
brew install himalayaRequires:
Himalaya is a CLI email client that lets you manage emails from the terminal using IMAP, SMTP, Notmuch, or Sendmail backends.
references/configuration.md (config file setup + IMAP/SMTP authentication)references/message-composition.md (MML syntax for composing emails)himalaya --version to verify)~/.config/himalaya/config.tomlRun the interactive wizard to set up an account:
himalaya account configureOr create ~/.config/himalaya/config.toml manually:
[accounts.personal]
email = "you@example.com"
display-name = "Your Name"
default = true
backend.type = "imap"
backend.host = "imap.example.com"
backend.port = 993
backend.encryption.type = "tls"
backend.login = "you@example.com"
backend.auth.type = "password"
backend.auth.cmd = "pass show email/imap" # or use keyring
message.send.backend.type = "smtp"
message.send.backend.host = "smtp.example.com"
message.send.backend.port = 587
message.send.backend.encryption.type = "start-tls"
message.send.backend.login = "you@example.com"
message.send.backend.auth.type = "password"
message.send.backend.auth.cmd = "pass show email/smtp"himalaya folder listList emails in INBOX (default):
himalaya envelope listList emails in a specific folder:
himalaya envelope list --folder "Sent"List with pagination:
himalaya envelope list --page 1 --page-size 20himalaya envelope list from john@example.com subject meetingRead email by ID (shows plain text):
himalaya message read 42Export raw MIME:
himalaya message export 42 --fullInteractive reply (opens $EDITOR):
himalaya message reply 42Reply-all:
himalaya message reply 42 --allhimalaya message forward 42Interactive compose (opens $EDITOR):
himalaya message writeSend directly using template:
cat << 'EOF' | himalaya template send
From: you@example.com
To: recipient@example.com
Subject: Test Message
Hello from Himalaya!
EOFOr with headers flag:
himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Message body here"Move to folder:
himalaya message move 42 "Archive"Copy to folder:
himalaya message copy 42 "Important"himalaya message delete 42Add flag:
himalaya flag add 42 --flag seenRemove flag:
himalaya flag remove 42 --flag seenList accounts:
himalaya account listUse a specific account:
himalaya --account work envelope listSave attachments from a message:
himalaya attachment download 42Save to specific directory:
himalaya attachment download 42 --dir ~/DownloadsMost commands support --output for structured output:
himalaya envelope list --output json
himalaya envelope list --output plainEnable debug logging:
RUST_LOG=debug himalaya envelope listFull trace with backtrace:
RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope listhimalaya --help or himalaya --help for detailed usage.references/message-composition.md).pass, system keyring, or a command that outputs the password.Generated Feb 16, 2026
Developers can use Himalaya to manage work emails directly from the terminal, integrating with existing CLI workflows. It allows listing, reading, and replying to emails without leaving the development environment, improving productivity by reducing context switching. This is useful for handling notifications, code reviews, or team communications efficiently.
System administrators can configure Himalaya to monitor server alerts and logs sent via email, enabling quick responses to critical issues from the command line. They can search, flag, and forward emails for incident management, streamlining operations without relying on GUI email clients. This supports remote server management and automation scripts.
Researchers can use Himalaya to handle email communications for collaborative projects, such as sharing papers or coordinating meetings, from a terminal-based setup. It supports multiple accounts for separating personal and institutional emails, with features like searching and attachments for managing research data. This enhances focus by minimizing distractions from graphical interfaces.
Freelancers can manage client emails efficiently using Himalaya to track project updates, invoices, and deadlines from the terminal. They can organize emails into folders, set flags for follow-ups, and use templates for quick replies, improving time management and professionalism. This is ideal for those working in remote or minimalist computing environments.
DevOps teams can integrate Himalaya into automation pipelines to send email notifications for build statuses, deployments, or alerts using CLI commands. By leveraging structured output formats like JSON, they can parse email data for monitoring tools, enhancing system observability and response automation. This reduces manual intervention in CI/CD workflows.
Offer Himalaya as a free, open-source tool to build a user base, while providing paid enterprise support, customization, and training services. This model attracts developers and organizations needing reliable email management, with revenue from support contracts and advanced features. It leverages community contributions for ongoing development and bug fixes.
Develop a cloud-based service that integrates Himalaya with other productivity tools, offering enhanced features like analytics, team collaboration, and API access. Charge subscription fees based on usage tiers, such as number of accounts or email volume, targeting businesses seeking scalable email solutions. This model provides recurring revenue and value-added services.
Provide consulting services to help organizations implement and optimize Himalaya for their specific workflows, including configuration, security audits, and integration with existing systems. Offer training workshops or online courses on using the CLI effectively, generating revenue from service fees and educational materials. This model capitalizes on expertise in terminal-based email management.
💬 Integration Tip
Integrate Himalaya with existing CLI tools like pass for secure password management and use its JSON output to pipe data into scripts or monitoring dashboards for automation.
Read and send email via IMAP/SMTP. Check for new/unread messages, fetch content, search mailboxes, mark as read/unread, and send emails with attachments. Works with any IMAP/SMTP server including Gmail, Outlook, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, and vip.188.com.
Gmail API integration with managed OAuth. Read, send, and manage emails, threads, labels, and drafts. Use this skill when users want to interact with Gmail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Automatically logs into email accounts (Gmail, Outlook, QQ Mail, etc.) and generates daily email summaries. Use when the user wants to get a summary of their emails, check important messages, or create daily email digests.
Fetch content from Feishu (Lark) Wiki, Docs, Sheets, and Bitable. Automatically resolves Wiki URLs to real entities and converts content to Markdown.
Manage Feishu (Lark) calendars by listing, searching, checking schedules, syncing events, and marking tasks with automated date extraction.
Set up Gmail API access via gog CLI with manual OAuth flow. Use when setting up Gmail integration, renewing expired OAuth tokens, or troubleshooting Gmail authentication on headless servers.