Disk Insights MCP

Ask Claude Desktop "what's eating my disk space?" — and get a real answer.

A tiny, read-only Model Context Protocol server. It reports your largest files and most bloated folders. It never deletes, moves, or modifies anything, and wide scans are time-bounded so they return useful results instead of hanging.

Runs 100% locally. Nothing leaves your machine.

What it does

All read-only. All offline.

Related MCP server: MCP Filesystem Python

Install (2 minutes)

Requirements: Python 3.10+ and the Claude Desktop app.

pip install "mcp[cli]"

Download disk_insights_mcp.py from this repo, then add it to your Claude Desktop config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "disk-insights": {
      "command": "python3",
      "args": ["/full/path/to/disk_insights_mcp.py"]
    }
  }
}

Restart Claude Desktop. Then just ask: "What's taking up space in my Downloads folder?"

A ready-to-edit claude_desktop_config.example.json is included.

Why read-only?

Disk cleanup tools that can delete files are exactly the tools you don't want an LLM driving unsupervised. This server only reports. You stay in control of what to remove.

Want the rest?

Disk Insights is one server from the MCP Starter Kit — a set of local-first servers for Claude Desktop, all MIT licensed:

• Doc Search — index a folder and search across everything, including the text inside PDFs and DOCX, fully offline (SQLite FTS5, no gigabyte model to download).

• Obsidian Vault — read/write/search/link notes in a local Obsidian vault.

• Git Companion — status, diffs, log, blame, and drafts real commit messages (commits require explicit confirm, never pushes).

• Plus File Manager, Web Scraper, SQLite, PDF Export and Notes in the original kit.

One-click installers for macOS/Linux/Windows, clean uninstaller, full docs: https://kuhnrichard.gumroad.com/l/kpllrc

Everything is MIT — you can always build your own from servers like this one.

License

MIT © Richard Kuhn — blog.kuhn.or.at