Log inSubmit server
Diskcleankit MCP logo

Diskcleankit MCP

Connects AI assistants to DiskCleanKit on macOS for local disk scans, cleanup, status checks, estimates, and history.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Diskcleankit MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "diskcleankit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vannamtran/diskcleankit-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y @vannamtran/diskcleankit-mcp

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1d ago.

Overview

The diskcleankit-mcp MCP server connects AI assistants to DiskCleanKit on macOS through the app's local URL scheme. It provides tools for scanning junk, cleaning safe caches and logs, checking disk status, estimating cleanable space, and viewing cleaning history. Use it when an MCP-compatible assistant needs to inspect or clean a Mac through the installed DiskCleanKit app. Processing stays local, and cleanup is limited to regenerable system and application files.

Use cases

  • Scan a Mac for junk without deleting files
  • Clean regenerable caches and application logs
  • Check available disk space and health status
  • Estimate cleanable space by category
  • Review previous cleaning sessions

Key features

  • Read-only junk-file scanning
  • One Touch cleanup for safe caches and logs
  • Disk space and health reporting
  • Category-based cleanable-space estimates
  • Cleaning history retrieval
  • Local URL-scheme communication with DiskCleanKit

Tools5

What Diskcleankit MCP lets your agent do. Expand a tool for its parameters.

Self-reported~69 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · @vannamtran/diskcleankit-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads141Package downloads in the last 30 days.
Last commit9mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed5Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Diskcleankit MCP works

What diskcleankit-mcp does

diskcleankit-mcp MCP server exposes DiskCleanKit's One Touch disk-cleaning functions to MCP-compatible AI assistants. It is intended for Macs with the DiskCleanKit application installed and provides both inspection and cleanup operations.

The available operations cover five common tasks:

  • Scan for junk without deleting anything.
  • Scan and clean safe items automatically.
  • Check available disk space and disk health status.
  • Estimate removable space by category.
  • Review earlier cleaning sessions.

The cleanup operation is limited to system caches, application caches, old application logs, and browser caches from Safari, Chrome, and Firefox. These files are described as regenerable; personal data and documents are not targeted.

How it works

The diskcleankit-mcp MCP server receives a tool request from the connected assistant and launches DiskCleanKit through its diskcleankit:// URL scheme. DiskCleanKit handles the requested operation and writes its result to /tmp/diskcleankit_mcp_response.json. The MCP process reads that file and returns the JSON response to the assistant.

This design requires the DiskCleanKit application to be available on the same Mac. A scan is read-only, while the clean operation performs a scan and then removes the supported safe items.

Setup and configuration

Install macOS, DiskCleanKit, and Node.js version 18 or later before configuring the diskcleankit-mcp MCP server. The recommended installation uses npm:

Terminal
npm install -g @vannamtran/diskcleankit-mcp

The repository can also be built from source with npm install followed by npm run build.

For a stdio client, configure the command as npx with @vannamtran/diskcleankit-mcp as its argument. The README provides configuration examples for Claude Desktop, Claude Code, Cursor, VS Code with GitHub Copilot, Cline, Windsurf, Zed, and Continue. Restart the client when required by its configuration workflow. Claude Code can alternatively register the server with claude mcp add --transport stdio.

Tools and capabilities

one_touch_scan performs a junk-file scan without deletion. one_touch_clean scans and cleans the supported safe categories. get_disk_status reports disk space and health status, while get_cleanable_estimate groups an estimate of removable space by category. get_cleaning_history returns past cleaning sessions.

Limitations and notes

The server is intended for macOS and depends on the DiskCleanKit app. If a request times out, the README recommends confirming that the app is installed and opening it manually first. ChatGPT is listed as unsupported because it does not natively support MCP. Ollama requires an intermediary such as mcphost rather than direct MCP support.

The scan tool does not delete files. The clean tool does modify the Mac, but the documented scope is limited to caches and logs that applications or the system can regenerate. No environment variables are specified for configuration.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Diskcleankit MCP

diskcleankit-mcp is an MCP server that connects AI assistants to the DiskCleanKit Mac app through its local URL scheme. Its main tools scan junk, clean safe caches and logs, report disk status, estimate cleanable space by category, and show previous cleaning sessions.

Install it with `npm install -g @vannamtran/diskcleankit-mcp` after installing DiskCleanKit and Node.js 18 or later on macOS. You can also clone the repository, run `npm install`, and build it with `npm run build`.

Yes, diskcleankit-mcp works with Cursor through its MCP configuration. Add the server to `~/.cursor/mcp.json` or the project-level `.cursor/mcp.json`, using `npx` with `@vannamtran/diskcleankit-mcp` as the argument.

The documented cleanup scope is limited to system and application caches, old application logs, and browser caches. Its scan tool never deletes files, while the clean tool removes only these supported regenerable items; personal data and documents are not touched.

Related MCP servers

All in OS Automation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDiskcleankit MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/diskcleankit-mcp?style=directory)](https://allmcps.com/mcp/diskcleankit-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/diskcleankit-mcp"><img src="https://allmcps.com/api/badge/diskcleankit-mcp?style=directory" alt="Diskcleankit MCP on AllMCPs" /></a>