DiskSpace AI
Analyze a Mac's disk, explain each folder and clean what recreates itself with 7-day undo
- Pricing
- Freemium
- Platforms
- macOS
- Runs
- Locally
- Version
- 1.0.28
- Listing updated
- 3 days ago
About DiskSpace AI
DiskSpace AI is a freemium MCP server for files and documents. It runs locally on your machine and is started by your AI client.
Disk cleanup tools tend to ask you to trust a list of folders. DiskSpace AI colours each one: green recreates itself and comes pre-selected, amber needs review, gray is your data and is only shown, and purple is unclassified. Unknown folders are explained by Apple's on-device AI, which never marks them safe.
The MCP server runs on your Mac and gives an agent six tools: analyze_disk, folder_contents, explain_folder, plan_cleanup as a dry run, clean, and undo_last_cleanup. The clean tool needs explicit confirmation and the agent is told to show the plan first. What recreates itself is deleted right away, your files are set aside for 7 days, and protected folders and anything used by open apps are left alone.
The app itself is not open source. It also finds duplicate photos and archives unused data. Analysing is free and cleaning is Pro, free during the beta.
Install
Run in a terminal
claude mcp add diskspace-ai -- npx -y https://github.com/diskspaceai/diskspace-ai/releases/download/v1.0.28/diskspace-ai-1.0.28.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"diskspace-ai": {
"command": "npx",
"args": [
"-y",
"https://github.com/diskspaceai/diskspace-ai/releases/download/v1.0.28/diskspace-ai-1.0.28.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"diskspace-ai": {
"command": "npx",
"args": [
"-y",
"https://github.com/diskspaceai/diskspace-ai/releases/download/v1.0.28/diskspace-ai-1.0.28.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"diskspace-ai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/diskspaceai/diskspace-ai/releases/download/v1.0.28/diskspace-ai-1.0.28.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"diskspace-ai": {
"command": "npx",
"args": [
"-y",
"https://github.com/diskspaceai/diskspace-ai/releases/download/v1.0.28/diskspace-ai-1.0.28.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"diskspace-ai": {
"command": "npx",
"args": [
"-y",
"https://github.com/diskspaceai/diskspace-ai/releases/download/v1.0.28/diskspace-ai-1.0.28.mcpb"
]
}
}
}Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- analyze_disk
- Free space and every known folder with size and safety
- folder_contents
- What is inside a folder, two levels deep
- explain_folder
- Explain an unknown folder with Apple's on-device AI
- plan_cleanup
- Dry run of what would be cleaned
- clean
- Clean chosen items with explicit confirmation
- undo_last_cleanup
- Restore what the last cleanup set aside
What it does
- Colour-coded folders
- Green, amber, gray and purple mark how safe each folder is.
- Dry-run plan
- plan_cleanup shows what would be cleaned without touching anything.
- 7-day undo
- Non-regenerable files are set aside and can be restored.
- On-device explanations
- Apple's AI explains unknown folders locally.
- Confirmation required
- clean needs explicit approval.
- One-click connect
- Settings connects Claude Code or Claude Desktop.
Good for
- Find what's taking up space on a Mac
- Clear developer caches after reviewing the plan
- Free 20 GB without touching personal files
- Identify an unfamiliar Application Support folder
Pricing
Freemium
Analysis free; cleaning is Pro, free during beta
Prices change. Check diskspaceai.com before you buy.
DiskSpace AI FAQ
Is cleaning free?
Analysing is free; cleaning is Pro, free during the beta.
Does it send my files anywhere?
It runs on your Mac. If your agent uses a cloud model, folder names, paths and sizes returned to it are seen by that service, never file contents.
Can I undo a cleanup?
Yes, undo_last_cleanup restores what was set aside, within 7 days.
Is DiskSpace AI free?
DiskSpace AI has a free plan, with paid plans for more usage or features.
How do I add DiskSpace AI to Claude Code?
Run this command in your terminal: claude mcp add diskspace-ai -- npx -y https://github.com/diskspaceai/diskspace-ai/releases/download/v1.0.28/diskspace-ai-1.0.28.mcpb
What are the best alternatives to DiskSpace AI?
The closest alternatives to DiskSpace AI are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.
Alternatives to DiskSpace AI

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents