Disk Clean
Find dev caches, big unused videos and old logs, then move approved items to the trash
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- today
Similar MCP servers
About Disk Clean
Disk Clean is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add diskclean-mcp-server -- uvx diskclean-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"diskclean-mcp-server": {
"command": "uvx",
"args": [
"diskclean-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"diskclean-mcp-server": {
"command": "uvx",
"args": [
"diskclean-mcp-server"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"diskclean-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"diskclean-mcp-server"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"diskclean-mcp-server": {
"command": "uvx",
"args": [
"diskclean-mcp-server"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"diskclean-mcp-server": {
"command": "uvx",
"args": [
"diskclean-mcp-server"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- 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
Pricing
Open source
Free and MIT licensed
Disk Clean 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.


