Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mu-mcpfind emails from Sarah about the project update"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
muindexClaude Desktop ready: simple installation and config
Python, uv, and MCP SDK based
Installation
Clone this repository and install dependencies:
Usage
Run the MCP Server
With uv:
Or directly with Python:
Claude Desktop Integration
Add to your claude_desktop_config.json:
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.