himalaya-mcp
This server provides comprehensive email management capabilities via the himalaya CLI, enabling reading, composing, organizing, and more — with multi-account support and safety mechanisms.
Read & Search: List, search, read (plain text or HTML), and export emails to Markdown. List and read full email threads/conversations.
Compose & Send: Draft new emails or replies (with reply-all support), with a two-phase confirmation/safety gate before actually sending.
Organize: Flag/unflag emails, move them between folders (Archive, Trash, Spam, etc.), and list, create, or delete folders.
Attachments: List and download email attachments, and extract calendar event details from ICS attachments.
Calendar: Create Apple Calendar events from email invites or manually (macOS only, with confirmation).
Productivity: Extract action items, todos, deadlines, and commitments from email content. Copy any text to the system clipboard.
Multi-Account Support: Perform all operations across multiple configured email accounts via a per-call
--accountparameter.Health & Diagnostics: Run health checks to verify himalaya installation and IMAP connectivity, with fix hints.
AI Prompts: Built-in MCP prompts for inbox triage, email summarization, daily/weekly digests, and morning briefings.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@himalaya-mcpShow my latest 5 emails in inbox"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
himalaya-mcp
Privacy-first email for Claude -- MCP server and Claude Code plugin (email) wrapping the himalaya CLI.
Features
29 MCP tools: list, search, read, flag, move, compose, draft reply, send (with safety gate), export, action items, clipboard, folders, attachments, calendar, threads, health check, get_unread_count, read_email_raw, render_email, list_starred, create_reminder, snooze_email, list_snoozed_emails
7 MCP prompts: triage inbox, summarize email, daily digest, weekly digest, draft reply, morning briefing, inbox check
3 MCP resources: inbox, message by ID, folders
16 plugin skills:
/himalaya:inbox,/himalaya:triage,/himalaya:digest,/himalaya:reply,/himalaya:compose,/himalaya:attachments,/himalaya:search,/himalaya:manage,/himalaya:stats,/himalaya:config,/himalaya:help,/himalaya:morning,/himalaya:forward,/himalaya:export,/himalaya:threads,/himalaya:respondMulti-account: per-call account switching via
--accountReliability: account-aware diagnostics via the
health_checktool and multi-accountdoctor; structured error envelopes with one-line fix hintsSafe subprocess: uses
execFile(no shell injection)Two-phase send:
send_emailreturns preview first, requires explicitconfirm=trueEnv-based config:
HIMALAYA_BINARY,HIMALAYA_ACCOUNT,HIMALAYA_FOLDER,HIMALAYA_TIMEOUT
Related MCP server: productivity-mcp
Install
Homebrew (recommended)
brew tap data-wise/tap
brew install himalaya-mcpInstalls himalaya CLI + Node.js as dependencies, auto-symlinks plugin to ~/.claude/plugins/.
himalaya-mcp doctor # Verify installationClaude Code Plugin (from GitHub)
Prerequisites: Node.js 22+ and himalaya CLI must be installed separately (brew install node himalaya).
claude plugin marketplace add Data-Wise/himalaya-mcp
claude plugin install himalayahimalaya-mcp doctor # Verify installationClaude Desktop (.mcpb -- one-click install)
Download himalaya-mcp-v{version}.mcpb from GitHub Releases and open it in Claude Desktop. Requires brew install himalaya separately -- the .mcpb does not bundle the himalaya CLI.
Claude Desktop (CLI setup)
himalaya-mcp setupDevelopment (from source)
npm install
npm run build
ln -s ~/projects/dev-tools/himalaya-mcp ~/.claude/plugins/himalaya-mcphimalaya-mcp doctor # Verify installationPrerequisites
himalaya CLI configured with at least one email account in
~/.config/himalaya/config.tomlNode.js 22+ (installed automatically by Homebrew)
Testing
npm test # 573 tests across 31 files (vitest)Category | Tests | Coverage |
Unit (parser, client, config, clipboard) | 41 | Core parsing, config, template variable guards |
Integration (tools, prompts) | 85 | Tool registration, MCP prompts, account validation |
Reliability (errors, retry, accounts, health) | 33 | Error envelope, transient retry, multi-account discovery, health_check |
v1.5.0 features | 79 | Threads (30), morning/inbox prompts (13), E2E integration (36) |
Dogfooding | 162 | Realistic Claude usage + reliability scenarios + .mcpb validation |
E2E | 39 | Full MCP server pipeline + structured envelope round-trip + .mcpb build pipeline |
Setup CLI | 45 | Setup, install/upgrade E2E, multi-account doctor, plugin structure, --help/--version |
Documentation
Full documentation at data-wise.github.io/himalaya-mcp
CLI man pages
The CLI ships with groff man pages following the flow-cli standard:
# After brew install himalaya-mcp, man pages are auto-installed to /opt/homebrew/share/man
man himalaya-mcp
man himalaya-mcp-doctor
man himalaya-mcp-setup
man himalaya-mcp-install-ext
man himalaya-mcp-remove-ext
# Or from the source repo:
MANPATH=$(pwd)/man man himalaya-mcpTroubleshooting
If an email tool fails, ask Claude:
Run a health check on my email accounts.This invokes the health_check MCP tool and surfaces a per-account status with one-line fix hints.
From a terminal, run:
himalaya-mcp doctor # All accounts
himalaya-mcp doctor --account <name> # Single accountFor the full failure-mode catalog and recovery steps, see docs/troubleshooting.md.
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceA generic IMAP and SMTP MCP server that enables AI agents to interact with email accounts for reading, searching, and sending messages. It provides high-level tools for managing email workflows like daily digests and folder organization across any standard email provider.Last updated1MIT
- AlicenseBqualityDmaintenanceA local MCP server that provides LLM clients with read/write access to email and calendar data from Gmail, iCloud, and generic IMAP providers. It runs entirely on your machine, keeping data private while enabling email management, calendar operations, and task handling through natural language.Last updated39MIT
- AlicenseAqualityDmaintenanceProvider-agnostic email MCP server that connects any IMAP mailbox to AI assistants, enabling email management through natural language.Last updated8AGPL 3.0
- Alicense-qualityDmaintenanceCross-platform MCP server and CLI for email operations, including send, read, search, and contact management, compatible with Gmail, Outlook, Yahoo, and any IMAP/SMTP providers.Last updated791MIT
Related MCP Connectors
Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Data-Wise/himalaya-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server