Skip to main content
Glama
Data-Wise

himalaya-mcp

by Data-Wise

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:respond

  • Multi-account: per-call account switching via --account

  • Reliability: account-aware diagnostics via the health_check tool and multi-account doctor; structured error envelopes with one-line fix hints

  • Safe subprocess: uses execFile (no shell injection)

  • Two-phase send: send_email returns preview first, requires explicit confirm=true

  • Env-based config: HIMALAYA_BINARY, HIMALAYA_ACCOUNT, HIMALAYA_FOLDER, HIMALAYA_TIMEOUT

Related MCP server: productivity-mcp

Install

brew tap data-wise/tap
brew install himalaya-mcp

Installs himalaya CLI + Node.js as dependencies, auto-symlinks plugin to ~/.claude/plugins/.

himalaya-mcp doctor    # Verify installation

Claude 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 himalaya
himalaya-mcp doctor    # Verify installation

Claude 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 setup

Development (from source)

npm install
npm run build
ln -s ~/projects/dev-tools/himalaya-mcp ~/.claude/plugins/himalaya-mcp
himalaya-mcp doctor    # Verify installation

Prerequisites

  • himalaya CLI configured with at least one email account in ~/.config/himalaya/config.toml

  • Node.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-mcp

Troubleshooting

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 account

For the full failure-mode catalog and recovery steps, see docs/troubleshooting.md.

License

MIT

Install Server
F
license - not found
A
quality
A
maintenance

Maintenance

Maintainers
1dResponse time
1wRelease cycle
20Releases (12mo)
Commit activity
Issues opened vs closed

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

  • A
    license
    -
    quality
    D
    maintenance
    A 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 updated
    1
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    A 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 updated
    39
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Cross-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 updated
    79
    1
    MIT

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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