Add it to Claude Code
claude mcp add mu-mcp -- uv run --directory PROJECT_PATH mcp run mu_mcp/mu_mcp.pyMake your agent remember this setup
mu-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Fast, structured mail search using the mu index
- Tool for querying and searching email messages
- Tool for viewing full email content
- Tool for opening attachments with the default OS viewer
- Stdio-based MCP server for easy integration
Tools 3
querySearch for emails within the mu mail index.view_emailRead the content of a specific email.open_attachmentOpen an email attachment using the default OS viewer.Try it
Original README from danielfleischer/mu-mcp
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.
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
muindex - 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
- Adding a tool to view an email.
- Adding a tool to find and download attachments.