LABSCO SUMMARY
Your mail stays where it is.
Because it reads an index that already exists on disk, there is no OAuth flow, no provider API, and nothing leaves the machine — which is a different privacy posture from every hosted mail connector. The three capabilities chain naturally: the README's own example is finding emails with a PDF attachment from a given month and opening the PDF, which is one instruction covering search, read and open.
What it is
An MCP server over the mu mail indexer, so an assistant can search mail that is already indexed on your machine. Nothing is uploaded and no mail provider is involved: the queries run against the local index.
What you get
- Fast, flexible search over the mu index using its own query syntax — sender, subject, date range, attachment presence
- Reading a matched email in the conversation, not just its headers
- Opening an attachment in the default OS viewer, so a PDF found by search can be opened in the same instruction
Requirements
A working mu mail index on the machine — the server queries it and does not build it. Python with pixi: clone and run pixi install, then pixi run start, or run python mu_mcp/mu_mcp.py directly. The client entry uses pixi with the manifest path pointing at the project. Transport is stdio. The package is mu_mcp (version 0.3.0).
Setup effort
Build from source — git clone https://github.com/danielfleischer/mu-mcp.git
USE CASES
01
Finding a message you only half remember
Search the local index by sender, subject or date range and read the match in the conversation.
02
Getting to an attachment fast
Search for messages with attachments in a period, then open the file in the system viewer without leaving the assistant.
03
Searching mail without handing it to a service
Query the index that is already on your machine, with no provider API and no upload.
BEFORE YOU INSTALL
What to know first
Requires
- pixi on PATH
- mu, with your mail already indexed
- An Apple Silicon Mac: the pixi manifest declares only the osx-arm64 platform
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/danielfleischer/mu-mcp.git
cd mu-mcp
pixi install
pixi run startMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mu_mcp": {
"command": "pixi",
"args": [
"run",
"--manifest-path",
"<YOUR_PROJECT_PATH>",
"start"
]
}
}
}<YOUR_PROJECT_PATH> is the full path of your clone's pyproject.toml, which holds the pixi manifest.