# Disk Clean

> Disk Clean is an open-source MCP server for files and documents. Find dev caches, big unused videos and old logs, then move approved items to the trash. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/kate941-su/diskcleaner-mcp
- **MCP Registry name:** io.github.Kate941-su/diskclean-mcp-server
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Safety is the point of the design. The server never deletes: approved items go to the operating system's trash so they can be restored, you see a list of candidates before anything moves, and only the items you approve are touched. It supports macOS, Linux and Windows, and the README adds that system folders are never touched.

What it looks for are three groups: developer caches (node_modules, __pycache__, Rust target folders, build and dist folders, Python virtual environments, Gradle and Cargo caches), videos over 100 MB not opened or changed in 90 days, and log files not updated in 30 days. Size and age limits can be changed by asking. Build and dist count only when a build file such as package.json sits beside them, and folders belonging to tools, such as the pnpm store or VS Code extensions, are skipped.

A scan runs up to 60 seconds, so large drives work better one folder at a time. Install it as a Claude Desktop extension or run it with uvx.

## Features

- **Candidate list first:** Shows path, type, size and last-modified date plus total space to free before anything moves.
- **Trash, not delete:** Approved items go to the OS trash and can be put back.
- **Dev cache detection:** Finds node_modules, virtual environments, build output and package caches.
- **Adjustable limits:** Ask for videos over 500 MB or logs older than a year.
- **Protected paths:** System folders, symlinks and tool-owned folders are never moved.

## Good for

- Free space on a laptop that is nearly full
- Clear old node_modules folders under a projects directory
- Find forgotten large videos
- Remove stale log files

## Install

### Claude Code (Terminal)

```sh
claude mcp add diskclean-mcp-server -- uvx diskclean-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "diskclean-mcp-server": {
      "command": "uvx",
      "args": [
        "diskclean-mcp-server"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "diskclean-mcp-server": {
      "command": "uvx",
      "args": [
        "diskclean-mcp-server"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "diskclean-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "diskclean-mcp-server"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "diskclean-mcp-server": {
      "command": "uvx",
      "args": [
        "diskclean-mcp-server"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "diskclean-mcp-server": {
      "command": "uvx",
      "args": [
        "diskclean-mcp-server"
      ]
    }
  }
}
```

## FAQ

### Does it permanently delete files?

No. Items are moved to the trash and space is freed when you empty it.

### Which systems work?

macOS, Linux and Windows.

### How do I install it?

Download the .mcpb for Claude Desktop, or run it with uvx in Claude Code, Cline or other clients.

### Why did a scan stop early?

One scan runs for up to 60 seconds; ask for a smaller folder.

### Is Disk Clean free?

Yes. Disk Clean is open source, so you can use and self-host it for free.

### How do I add Disk Clean to Claude Code?

Run this command in your terminal: claude mcp add diskclean-mcp-server -- uvx diskclean-mcp-server

### What are the best alternatives to Disk Clean?

The closest alternatives to Disk Clean are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/disk-clean
