Claude MarketplacesSubmit

Diskcleankit Mcp

namtran/diskcleankit-mcp

Bridges Claude and other MCP clients to DiskCleanKit's Mac cleaning app through URL scheme automation. Exposes five tools: one_touch_scan for safe junk file discovery, one_touch_clean to automatically remove system caches and logs, get_disk_status for space monitoring, get_cleanable_estimate for category breakdowns, and get_cleaning_history for past sessions. The server sends commands via diskcleankit:// URLs and reads responses from temporary JSON files. Useful when you want conversational disk maintenance without leaving your AI assistant. Only touches regenerable files like browser caches and application logs, never personal documents. Requires DiskCleanKit installed and runs entirely local with no external server calls.

GitHub stars: 1
tools: 5
transport: STDIO
last updated: Dec 28, 2025

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

one_touch_scanScan for junk files (safe, no deletion)

Scan for junk files (safe, no deletion)

No parameter schema in public metadata yet.

one_touch_cleanRecommended - Scan AND clean junk files automatically

Recommended - Scan AND clean junk files automatically

No parameter schema in public metadata yet.

get_disk_statusCheck disk space and health status

Check disk space and health status

No parameter schema in public metadata yet.

get_cleanable_estimateEstimate cleanable space by category

Estimate cleanable space by category

No parameter schema in public metadata yet.

get_cleaning_historyView past cleaning sessions

View past cleaning sessions

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Readme

DiskCleanKit MCP Server

MCP (Model Context Protocol) server that enables AI assistants like Claude to control DiskCleanKit's One Touch feature for Mac disk cleaning.

Prerequisites

macOS
DiskCleanKit app installed
Node.js v18+

Installation

Via npm (Recommended)

npm install -g @vannamtran/diskcleankit-mcp

From Source

git clone https://github.com/namtran/diskcleankit-mcp
cd diskcleankit-mcp
npm install
npm run build

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

Then restart Claude Desktop.

Claude Code (CLI)

claude mcp add --transport stdio diskcleankit -- npx @vannamtran/diskcleankit-mcp

Or edit ~/.claude/settings.json:

View the full README on GitHub

Details

Repository: github.com/namtran/diskcleankit-mcp
Package: @vannamtran/diskcleankit-mcp
Transport: STDIO
Registry: MCP registry, active