Diskcleankit Mcp

io.github.namtranPublished by GitHub account namtranv1.0.0Updated Oct 24, 2026

MCP server for DiskCleanKit - One Touch Scan and Clean for Mac

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & Storage

Overview

AI-generated overview

Lets an assistant scan and clean macOS junk files through the DiskCleanKit app, and report disk space and cleaning history.

What you can do
This MCP server exposes DiskCleanKit's One Touch feature to an AI assistant. Tools include one_touch_scan (scan only, no deletion), one_touch_clean (scan and clean automatically), get_disk_status, get_cleanable_estimate, and get_cleaning_history. It works by triggering the DiskCleanKit app through a diskcleankit:// URL scheme and reading the app's response from a temporary file.
When to use it
Use it on a Mac when you want an assistant to check disk space, estimate reclaimable space, or clear system, application, and browser caches and old logs. It is aimed at routine macOS disk cleanup rather than general file management.
Requirements
macOS with the DiskCleanKit app installed, plus Node.js v18 or later to run the npm package @vannamtran/diskcleankit-mcp over stdio. No authentication, environment variables, or headers are declared. The server is desktop-only and not web-executable.
Before you install
one_touch_clean deletes files without a separate confirmation step, though the README says it targets only regenerable caches and logs. Review what it reports as cleanable before running it, and note that the server communicates with the DiskCleanKit app through a URL scheme and a temporary response file on the local machine.

Installation

In SourceWeft

  1. Open Diskcleankit Mcp 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

DiskCleanKit MCP Server

[npm version]

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

Prerequisites

Installation

Via npm (Recommended)

bash
npm install -g @vannamtran/diskcleankit-mcp

From Source

bash
git clone https://github.com/namtran/diskcleankit-mcpcd diskcleankit-mcpnpm installnpm run build

Configuration

Claude Desktop

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

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

Then restart Claude Desktop.

Claude Code (CLI)

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

Or edit ~/.claude/settings.json:

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

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-specific):

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

Or go to Cursor Settings → Tools & Integrations → New MCP Server.

VS Code (GitHub Copilot)

Add to your settings.json:

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

Other MCP Clients

ClientConfig File
ClineVS Code extension settings
Windsurf~/.windsurf/mcp.json
Zed~/.config/zed/settings.json
Continue~/.continue/config.json

Use the same configuration structure:

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

Ollama (via mcphost)

Ollama doesn't natively support MCP, but you can use mcphost:

bash
pip install mcphostmcphost -m ollama:qwen2.5 --config config.json

Unsupported

  • ChatGPT: No native MCP support

Available Tools

ToolDescription
one_touch_scanScan for junk files (safe, no deletion)
one_touch_cleanRecommended - Scan AND clean junk files automatically
get_disk_statusCheck disk space and health status
get_cleanable_estimateEstimate cleanable space by category
get_cleaning_historyView past cleaning sessions

What Gets Cleaned

one_touch_clean automatically scans and cleans safe items only:

CategoryDescription
System CachesmacOS system cache files
Application CachesApp-generated cache files
Application LogsOld log files from apps
Browser CachesSafari, Chrome, Firefox cache

These are all safe to delete and will be regenerated by the system/apps as needed.

Usage Examples

Once configured, ask your AI assistant:

  • "Scan my Mac for junk files" → one_touch_scan
  • "Clean up my Mac" → one_touch_clean
  • "How much disk space do I have?" → get_disk_status
  • "What can be cleaned?" → get_cleanable_estimate
  • "Show my cleaning history" → get_cleaning_history

How It Works

AI Assistant → MCP Server → URL Scheme → DiskCleanKit App                   ↑                            ↓              JSON Response ← Temp File ← Response
  1. AI calls MCP server tools
  2. MCP server triggers DiskCleanKit via diskcleankit:// URL scheme
  3. DiskCleanKit processes request and writes response to /tmp/diskcleankit_mcp_response.json
  4. MCP server reads response and returns to AI

Security

  • one_touch_scan is safe - only scans, never deletes
  • one_touch_clean automatically scans AND cleans safe items (caches & logs only)
  • Only cleans regenerable files - no personal data or documents are ever touched
  • All processing happens locally on your Mac
  • No data sent to external servers

Note: one_touch_clean is safe to run directly - it only removes system/app caches and logs that will be regenerated automatically.

Troubleshooting

"Timeout waiting for response"

  • Ensure DiskCleanKit app is installed
  • Try opening DiskCleanKit manually first

Server not appearing in Claude

  • Verify config path is correct
  • Restart Claude Desktop after config changes
  • Check Claude logs for errors

License

MIT

Links

Source: README.md at commit 28bfdc4

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 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