mu-mcp

danielfleischer/mu-mcp

3.3

If you are the rightful owner of mu-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

mu-mcp is an MCP server designed for querying the local 'mu' mail index, enabling fast and structured mail searches.

Tools

  1. query

    Tool to perform complex email searches using the 'mu' index.

  2. view emails

    Tool to view the content of emails directly.

  3. open attachments

    Tool to open email attachments using the default OS viewer.

mu-mcp: MCP Server for the mu Mail Indexer

GitHub release GitHub license

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 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

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