Mu

Provides fast, MCP-based access to a local mu mail index for querying, viewing emails, and attachments.

python

2

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP server lets you query your local mu mail index with fast, structured search from MCP clients like Claude Desktop. It exposes tools to run queries, view emails, and open attachments, enabling seamless, index-backed mail discovery from your workflow.

How to use

You connect an MCP client to the mu_mcp server to search and retrieve mail data from your mu index. Use the client’s natural language prompts to perform complex searches like finding emails with specific attachments, locating messages from a particular sender, or filtering by date ranges. The server exposes three core tools: querying mail, viewing an email, and opening attachments with your default OS viewer. Start the server locally and point your MCP client to the configured command path, then issue queries through the client’s interface to receive structured results.

How to install

Prerequisites: you need Python and the uv tool (uvx) installed on your system. You will also need git to clone the project.

Step 1: Clone the repository and navigate into it.

Step 2: Create a Python virtual environment using uv and install the package.

Step 3: Run the MCP server using the included script.

Claude Desktop Integration

Configure Claude Desktop to use the mu_mcp MCP server by adding a server entry to your claude_desktop_config.json.

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

Available tools

query

Run a structured search against the mu index to locate emails based on content, metadata, and attributes.

view_email

Open and display the full content of a selected email in the client or default viewer.

open_attachment

Find and open attachments from emails using the system's default application for the file type.