Skip to content
MCP server

DiskSpace AI

Analyze a Mac's disk, explain each folder and clean what recreates itself with 7-day undo

Runs locallyStatus and history
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents