https://github.com/danielfleischer/mu-mcp
MCP server for the `mu` email indexer and searcher.
https://github.com/danielfleischer/mu-mcp
claude-desktop email mcp-server mu4e
Last synced: 4 months ago
JSON representation
MCP server for the `mu` email indexer and searcher.
- Host: GitHub
- URL: https://github.com/danielfleischer/mu-mcp
- Owner: danielfleischer
- License: gpl-3.0
- Created: 2025-06-21T09:21:50.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2025-06-21T10:11:22.000Z (4 months ago)
- Last Synced: 2025-06-21T10:28:04.414Z (4 months ago)
- Topics: claude-desktop, email, mcp-server, mu4e
- Language: Python
- Homepage:
- Size: 38.1 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mu-mcp: MCP Server for the `mu` Mail Indexer
[](https://github.com/danielfleischer/mu-mcp/releases)
[](https://github.com/danielfleischer/mu-mcp/blob/master/LICENSE)
A Model Context Protocol (MCP) server for querying your local [`mu`](https://github.com/djcb/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:
```sh
git clone https://github.com/danielfleischer/mu-mcp.git
cd mu-mcp
uv venv
uv pip install .
```
## Usage
### Run the MCP Server
With [uv](https://github.com/astral-sh/uv):
```sh
uv run --directory . mcp run mu_mcp/mu_mcp.py
```
Or directly with Python:
```sh
python mu_mcp/mu_mcp.py
```
### Claude Desktop Integration
Add to your `claude_desktop_config.json`:
```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
- [x] Adding a tool to view an email.
- [x] Adding a tool to find and download attachments.