# DiskSpace AI

> DiskSpace AI is a freemium MCP server for files and documents. Analyze a Mac's disk, explain each folder and clean what recreates itself with 7-day undo. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** macOS
- **Website:** https://diskspaceai.com/mcp
- **Repository:** https://github.com/diskspaceai/diskspace-ai
- **MCP Registry name:** com.diskspaceai/diskspace-ai
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add diskspace-ai -- npx -y https://github.com/diskspaceai/diskspace-ai/releases/download/v1.0.28/diskspace-ai-1.0.28.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/diskspace-ai
