Distill Mcp
About
# Distill MCP Server [](https://swift.org) [](https://apple.com/macos) [](LICENSE)…
Explore
- Exposes 9 MCP tools including rename, preview, undo, folder monitoring
- Supports five AI providers: Claude, OpenAI, Gemini, Ollama, Apple Intelligence
- Reads PDFs, images (OCR), Office docs, emails, HTML, RTF, and media
- Fully local mode with Ollama (no data leaves your Mac)
- Configurable naming rules: date format, casing, categories, custom templates
- Pay-per-use credits starting at €1.99 per 100 renames (free trial available)
1. macOS 14 (Sonoma) or later
2. Distill app installed and running — get it here (free, pay-per-use credits start at €1.99 / 100 renames)
3. Swift 5.9+ (Xcode 15+) if building from source
| Variable | Default | Description |
|---|---|---|
| DISTILL_PORT | 22200 | Port of Distill's local HTTP server |
| DISTILL_TOKEN | _(none)_ | Bearer token from Distill Settings (required) |
Errors and trace logs go to stderr so they don't pollute the JSON-RPC stdout channel.
---
Let Claude, Cursor, or any MCP client rename files for you — automatically, based on content.
This is the official Model Context Protocol bridge for Distill — a native macOS app that uses AI (Claude, OpenAI, Gemini, Ollama, or Apple Intelligence) to read your files and rename them with descriptive, consistent names. No more IMG_4521.jpg or Scan_003.pdf — get 250401 Invoice Telekom.pdf instead.
> You need the Distill app installed and running. This MCP server is a stdio→HTTP bridge — the actual file analysis happens in the app. Get Distill at store.juergenkoller.software/apps/distill.
---
What you can do
> "Claude, look at the 47 PDFs in ~/Downloads, rename them based on content, but show me the suggestions first."
The MCP server exposes 9 tools:
| Tool | What it does |
|---|---|
| rename_files | Analyze file content with AI and rename with descriptive names |
| suggest_names | Suggest new names without renaming (preview mode) |
| revert_rename | Undo a previous rename |
| get_rename_history | Show the rename history (timestamps, before/after, AI provider used) |
| watch_folder | Add a folder to auto-monitoring (new files get renamed in the background) |
| app_status | Current state, AI provider, credits left, watched folders |
| set_provider | Switch AI provider — Claude, OpenAI GPT-4o, Gemini, Ollama (local), Apple Intelligence |
| get_rules | Show naming rules (date format, casing, categories, custom templates) |
| set_rules | Update naming rules |
Distill reads PDFs, images (via OCR), Office documents, emails, HTML, RTF, and media files. It extracts date, category, description, sender, and amounts — then builds filenames using your configurable rules.
---
Installation
Prerequisites
1. macOS 14 (Sonoma) or later
2. Distill app installed and running — get it here (free, pay-per-use credits start at €1.99 / 100 renames)
3. Swift 5.9+ (Xcode 15+) if building from source
Build from source
```bash
git clone https://github.com/juergenkoller-software/distill-mcp.git
cd distill-mcp
swift build -c release
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
