Ask your agent.

Connect with one click

1. Install DiskSpace AI (or update to 1.0.5 or later).
2. Open Settings → AI → Connect your AI agent and click Connect for Claude Code or Claude Desktop. No Terminal needed.
3. Start a new session and ask “what's taking up space on my Mac?”.

Claude Code works inside the Claude desktop app too.

Claude plugin and extension

The DiskSpace AI plugin teaches Claude to clean step by step: analyze, explain, show you the plan and wait for your yes. In Claude Code:

/plugin install diskspace-ai --marketplace diskspaceai/claude-plugin

For Claude Desktop without the app, download diskspace-ai-<version>.mcpb from the latest release and double-click it. It's in the official MCP Registry as com.diskspaceai/diskspace-ai.

Other agents

Codex:

codex mcp add diskspace-ai -- "/Applications/DiskSpace AI.app/Contents/MacOS/diskspace" mcp

Claude Code from Terminal:

claude mcp add diskspace-ai -- "/Applications/DiskSpace AI.app/Contents/MacOS/diskspace" mcp

If you installed it with Homebrew, the command is just diskspace.

Cursor, Windsurf and any other that uses the MCP JSON config:

{"mcpServers": {"diskspace-ai": {"command": "/Applications/DiskSpace AI.app/Contents/MacOS/diskspace", "args": ["mcp"]}}}

What your agent can do

• analyze_diskAnalyzes the disk: free space and every known folder with its size, what it is, whether it's safe to delete and how to clean it.Read-only
• folder_contentsWhat's inside a folder, two levels deep, skipping folders that only wrap another one.Read-only
• explain_folderExplains an unknown folder with Apple's AI, on your Mac. It never marks it as safe.Read-only
• plan_cleanupDry run: what would be cleaned and why the rest is skipped. Touches nothing.Read-only
• cleanCleans what you choose. Only with explicit confirmation; your files are kept 7 days.Asks first
• undo_last_cleanupRestores what the last cleanup set aside.Undo

The same guarantees as the app

• It never cleans without your OK. The clean tool requires explicit confirmation, and the agent is told to show you the plan first.
• Your files are kept 7 days. Only what recreates itself is deleted right away; everything else can be undone.
• Your protected folders are never touched, nor anything from open apps.
• Analyzing is free; cleaning is Pro (free during the beta).

Privacy

DiskSpace AI runs entirely on your Mac: the MCP server only talks to the agent you have open, and Apple's AI that explains folders is local too.

But if your agent uses a cloud model (Claude, ChatGPT…), what DiskSpace AI returns to it —folder names, paths and sizes, never the contents of your files— is seen by that service, like anything else you ask it.

Try asking

• “What's taking up space on my Mac?”
• “Free up 20 GB without touching my files.”
• “What's inside my Xcode simulators?”
• “What is ~/Library/Application Support/kimi-desktop?”
• “Clean the developer caches and show me the plan first.”