# DiskSpace AI

DiskSpace AI inspects your Mac drive, categorizes bloated directories, and lets coding agents clean up recreateable caches with a seven-day safety net.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 repo stars
- Author: diskspaceai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/diskspaceai/diskspace-ai
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/diskspace-ai

## What it 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.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- 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
- 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.

## Similar
- [macos-cleaner](https://affpapa.org/en/nevibecode/skills/macos-cleaner.md) — skill · 1900 installs
- [disk-hygiene](https://affpapa.org/en/nevibecode/skills/disk-hygiene.md) — skill · 273 installs
- [puremac-macos-cleaner](https://affpapa.org/en/nevibecode/skills/puremac-macos-cleaner.md) — skill · 491 installs
- [XcodeBuildMCP](https://affpapa.org/en/nevibecode/mcp/xcodebuildmcp.md) — MCP server · ★ 6596 repo stars
- [xcodemcp](https://affpapa.org/en/nevibecode/mcp/xcodemcp.md) — MCP server · ★ 59 repo stars
- [Xcode: MCP Bridge Wrapper for Cursor](https://affpapa.org/en/nevibecode/mcp/xcode-mcp-bridge-wrapper-for-cursor.md) — MCP server · ★ 20 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
