DiskSpace AI — Claude Code MCP server: what it does, how to install
DiskSpace AI inspects your Mac drive, categorizes bloated directories, and lets coding agents clean up recreateable caches with a seven-day safety net.
no license ★ 2 updated 2026-10-28
Open on GitHubWhat DiskSpace AI does
This tool connects coding agents to a Mac disk inspection utility. It spots development residue across your drive, including uv, npm, and Homebrew caches, dormant node_modules, Xcode artifacts, Docker storage, and old simulator runtimes. Unknown directories are evaluated locally on your Mac.
Safety is built around regeneration rules. Content that recreates itself automatically can be cleared immediately. Important files marked for deletion move into temporary storage for 7 days so you can restore them if needed. Inactive directories can also be archived into verified .zip files.
The server requires macOS 15 or newer, meaning older operating system releases will fail to run it. It runs natively on both Apple silicon and Intel machines. AI agents must ask for explicit approval before purging any files.
What it helps with
- identify massive package caches from npm, uv, and Homebrew
- remove unused Docker data and old simulator runtimes
- reclaim macOS storage with a seven-day file restore period
- compress inactive project directories into verified zip archives
Example prompts for the agent
- Scan the Mac drive with DiskSpace AI and show which package caches can be safely erased.
- Find unused Docker layers and Xcode build data taking up drive space.
- List directories that can recreate themselves and wait for my confirmation before deleting.
How to install DiskSpace AI
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about DiskSpace AI
How to install DiskSpace AI?
Install the Mac app using Homebrew with brew install --cask diskspaceai/tap/diskspace-ai. Afterwards, configure your AI agent using the application's MCP connection guide.
What does DiskSpace AI do?
It lets coding assistants inspect your Mac storage, identify disposable developer caches, and propose cleanups while keeping deleted files recoverable for 7 days.
What are the requirements to run this server?
You need a Mac powered by Apple silicon or Intel running macOS 15 or later. All cataloging and file checks happen strictly on-device without telemetry.