Disk Clean

io.github.Kate941-suPublished by GitHub account Kate941-suv0.1.0Updated Nov 7, 2026

Find dev caches, large unused videos and old logs, then move approved items to the OS trash.

The publisher's own server: Clean

VerifiedSTDIODesktop onlyFiles & StorageDeveloper Tools

Overview

AI-generated overview

Local MCP server that scans a folder for dev caches, large unused videos and old logs, then moves only the items you approve to the OS trash.

What you can do
  • Scan folders and report what is using disk space, with candidate paths, types, sizes and last-modified dates plus total space that could be freed
  • Filter candidates by type, size and age limits you specify, such as videos over 500 MB or logs older than a year
  • Move only the approved items to the OS trash and return a report of what was moved
  • Skip protected locations such as system folders, the home folder itself, symbolic links and tool-owned node_modules or virtual environments
When to use it
Useful when a disk is filling up and you want an assistant to find reclaimable space in a home folder or project directory, review a list of candidates, and clear only what you confirm. It suits developer machines with accumulated caches, old logs and large unused videos.
Requirements
Runs locally over stdio on macOS, Linux or Windows. Claude Desktop can install the packaged extension, which sets up Python itself; other clients use uvx, so uv must be installed (Python is not needed separately). No accounts, API keys or environment variables are declared. Read permission on the folders you scan; macOS may need Full Disk Access for some folders.
Before you install
It moves files, so approved items leave their original location and disk space is only freed once the trash is emptied; restore from the OS trash if needed. Scans are limited to 60 seconds and unreadable folders are skipped. Granting Full Disk Access widens what it can read. Review the candidate list before approving, since approval is what triggers the move.

Installation

In SourceWeft

  1. Open Disk Clean in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Disk Clean MCP Server

日本語 | English

Ask Claude or another AI assistant to "clean up my disk". This MCP server finds the files that eat your disk space and moves them to the trash.

  • Nothing is deleted. Items go to the OS trash, so you can restore them later
  • You always see a list first, and only the items you approve are moved
  • System folders are never touched

Supported OS: macOS / Linux / Windows

What it finds

TypeExamples
Developer cachesnode_modules, __pycache__, Rust target/, build/ and dist/, Python virtual environments (.venv), ~/.gradle/caches, ~/.cargo/registry
Large, unused videos.mp4, .mov, .mkv and other videos over 100 MB that have not been opened or changed in 90 days
Old logs.log and .log.gz files not updated in 30 days

You can change the size and age limits when you ask (for example "videos over 500 MB" or "logs older than a year").

Install

Claude Desktop (easiest)

  1. Download the latest diskclean-mcp-server-*.mcpb from Releases
  2. Double-click the file, or drag it into Claude Desktop's Settings → Extensions
  3. Click Install

Claude Desktop sets up Python and everything else for you.

Other apps (Claude Code, Cline, manual setup)

These use uv to download and run the server. You do not need to install Python yourself.

Step 1. Install uv

macOS / Linux:

bash
curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Open a new terminal and check that uv --version works.

Step 2. Add the server to your app

Claude Code
bash
claude mcp add --scope user diskclean -- uvx diskclean-mcp-server

--scope user makes it available in every project.

Optional: install the skill that teaches Claude the safe cleanup steps.

bash
mkdir -p ~/.claude/skills/disk-cleanupcurl -fsSL https://raw.githubusercontent.com/Kate941-su/diskcleaner-mcp/main/.claude/skills/disk-cleanup/SKILL.md \  -o ~/.claude/skills/disk-cleanup/SKILL.md
Claude Desktop (manual setup)

Open the config file:

OSConfig file
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

Add the following and restart Claude Desktop:

json
{  "mcpServers": {    "diskclean": {      "command": "uvx",      "args": ["diskclean-mcp-server"]    }  }}
Cline (VS Code)

Open the config file from Cline's MCP Servers screen and add the same entry as above.

How to use

Ask your assistant in plain words:

My disk is full. Find files I don't need in my home folder.
Clean up all the node_modules folders under ~/projects.
Find videos in ~/Movies over 1 GB that I haven't watched in six months.
Show me what is using space in ~/Library/Caches, two levels deep.

What happens

  1. The assistant looks at the folder and tells you what is using the space
  2. You get a list of candidates (path, type, size, last modified) and the total space you can free. Nothing has been moved yet
  3. You say what to move ("all of them", "only node_modules", "everything except #3")
  4. Only the approved items go to the trash, and you get a report

Restoring files

Everything goes to the trash, so you can bring it back at any time.

  • macOS: open the Trash in Finder, right-click the item and choose Put Back
  • Windows: open the Recycle Bin, right-click the item and choose Restore
  • Linux: open the trash in your file manager and choose Restore (stored in ~/.local/share/Trash)

Disk space is actually freed when you empty the trash.

What is never moved

  • OS system folders (/usr, /System, C:\Windows, C:\Program Files, and so on)
  • Your home folder itself, and folders directly under the disk root
  • Anything that was not in the list you were shown
  • Symbolic links (and the files they point to)
  • node_modules and virtual environments that belong to tools and apps, not to your projects: the pnpm store, Node.js installed by nvm, VS Code extensions, and anything inside ~/Library, ~/AppData or hidden folders in your home folder. Removing these would break the tool

build/ and dist/ only count as caches when a build file such as package.json sits next to them, so normal folders with the same name are not picked up by mistake.

Updating

The Claude Desktop extension: download the new .mcpb from Releases and install it again.

With uvx: uv keeps a cached copy. To get the latest version, run the following and restart your app.

bash
uv cache clean diskclean-mcp-server

To always start the newest version, use "args": ["diskclean-mcp-server@latest"] instead. This checks for updates every time the server starts.

Troubleshooting

The tools don't show up in my assistant

  • Restart the app after changing settings
  • Claude Desktop may not find uvx. Put the full path in "command". Find it with which uvx on macOS / Linux or where uvx on Windows
  • In Claude Code, check with claude mcp list

"Some folders could not be read" (skipped_errors)

  • Folders you don't have permission to read are skipped. On macOS, giving the app Full Disk Access may help (System Settings → Privacy & Security)

The scan stopped early (timed_out)

  • One scan runs for up to 60 seconds. Ask for a smaller folder, such as ~/projects

For developers

See docs/DESIGN.md for the design, tool specs, development setup and release process (in Japanese).

License

MIT

Source: README.md at commit 590ac26

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the package did not install.

Version history

1
  1. v0.1.0LatestOct 30, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Clean integrations

Clean

tools.cleanOfficial publisher

Clean is a read-only utility MCP server offering deterministic cron, date, finance, text, encoding, color and conversion tools for assistants.

Streamable HTTPWeb executable
Finance42 toolsOct 24, 2026

Clean Yield Data Tools

Published by GitHub account cleanyield-data

Apify-backed MCP server giving an assistant five scraping tools for company enrichment, FMCSA carriers, app reviews, ATS jobs and LatAm tenders.

Streamable HTTPWeb executableAuth
Web Search & ScrapingCredential requiredNov 7, 2026

DataClean

Published by GitHub account ArceeDev

DataClean profiles, cleans, normalizes and validates CSV/Excel tables deterministically, flagging ambiguous values instead of guessing.

Streamable HTTPWeb executableAuth
Files & StorageCredential requiredNov 7, 2026

Tendmark Buildings: Organize my building’s Clean Buildings compliance

com.forevenza.services

Submits Washington State Clean Buildings compliance scope and indicative fee requests to Tendmark Buildings, then tracks offers and orders.

Streamable HTTPWeb executable
Productivity & Workflow7 toolsNov 7, 2026

Clean

Published by GitHub account cleanmcp

Clean is a hosted MCP server that lets an assistant research B2B leads against your ideal customer profile, read results, and draft outreach sequences.

Streamable HTTPWeb executableAuth
Communication & CollaborationCredential requiredNov 6, 2026