mu-mcp

An MCP server that lets your local LLM search your email using mu.

Privacy

Your emails never leave your machine.

mu indexes your local maildir and searches it entirely on-device — no email content is sent to any server. When paired with a local LLM such as Qwen, Mistral, or Llama running via Ollama, the full pipeline is local:

your emails → mu index (local) → mu-mcp → local LLM

Nothing touches the internet. This is in contrast to cloud-based email AI integrations that require granting third-party services access to your inbox.

If you use a cloud LLM (e.g. Claude, GPT-4), be aware that email metadata — subjects, sender addresses, dates, and full message bodies if you invoke get_email — will be sent to that provider as part of the conversation context.

Requirements

• mu 1.x installed and your maildir indexed (mu init && mu index)
• Python 3.14
• uv

Installation

git clone ...
cd mu-mcp
uv sync

MCP client configuration

{
  "mcpServers": {
    "mu": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/mu-mcp",
        "mu-mcp"
      ]
    }
  }
}

Tools

search_emails(query, max_results, sort_field, sort_order) Search your maildir using mu query syntax. Returns email metadata (subject, sender, date, path, flags).

get_email(path) Retrieve the full content of a message by its file path (as returned by search_emails). Returns headers and body as plain text.