mu-mcp: MCP Server for the mu Mail Indexer

A Model Context Protocol (MCP) server for querying your local mu mail index. This server enables fast, structured mail search from Claude Desktop and other MCP clients.

<img src="assets/claude-screenshot.png" width="500"/>

Features

• Stdio MCP server for easy integration
• Three tools: query, view emails and open attachments (using default OS viewer).
• Fast, flexible mail search using the mu index
• Claude Desktop ready: simple installation and config
• Python, uv, and MCP SDK based

Installation

Clone this repository and install dependencies:

git clone https://github.com/danielfleischer/mu-mcp.git
cd mu-mcp
uv venv
uv pip install .

Usage

Run the MCP Server

With uv:

uv run --directory . mcp run mu_mcp/mu_mcp.py

Or directly with Python:

python mu_mcp/mu_mcp.py

Claude Desktop Integration

Add to your claude_desktop_config.json:

"mcpServers": {
  "mu_mcp": {
    "command": "uv",
    "args": [
      "run",
      "--directory",
      "PROJECT_PATH",
      "mcp",
      "run",
      "mu_mcp/mu_mcp.py"
    ]
  }
}

Replace PROJECT_PATH with the path to your cloned repo.

Query

Ask Claude to find emails, e.g. "Find emails with a PDF attachment that were sent last April and open the PDF", "Show me the email I received from Alice last week", or "Find emails with the subject 'Meeting Notes'".

Development

• [x] Adding a tool to view an email.
• [x] Adding a tool to find and download attachments.