DiskCleanKit

The DiskCleanKit MCP Server lets AI assistants control DiskCleanKit’s One Touch cleaning flow on macOS through the Model Context Protocol, enabling automated disk cleaning actions from your preferred AI partner while keeping all processing local to your Mac.

How to use

You can use this MCP server with any compatible MCP client to run predefined tools that scan, estimate, and clean junk files on your Mac. The available actions focus on safe, regenerable data like system caches and logs, and you interact with them by triggering the corresponding tools from your AI assistant.

How to install

Prerequisites you need before installing are macOS, the DiskCleanKit app, and Node.js version 18 or later.

Install the MCP server globally using the following command:

npm install -g @vannamtran/diskcleankit-mcp

Configuration

Configure the MCP server in your client’s settings to enable Claude Desktop, Claude Code, Cursor, VS Code, and other MCP clients to communicate with DiskCleanKit.

Claude Desktop configuration

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

After adding this configuration, restart Claude Desktop to apply the MCP server connection.

Claude Code (CLI) configuration

Add the MCP server via the Claude CLI or by editing your settings to include the same command and arguments.

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

Or edit your settings file to include the MCP server entry.

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

Cursor configuration

Add the MCP server to Cursor globally or per-project by updating the MCP configuration file.

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

VS Code (GitHub Copilot) configuration

In your VS Code settings, add the MCP server with the same command and arguments.

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

Other MCP clients

Use the same structure for other MCP clients. Create an entry named "diskcleankit" and set the command to npx with the argument @vannamtran/diskcleankit-mcp.

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

Ollama (via mcphost)

Ollama can be used with MCP through mcphost. Install mcphost and run a config that points Ollama to the MCP server.

pip install mcphost
mcphost -m ollama:qwen2.5 --config config.json

Unsupported clients

Some clients do not natively support MCP. If a client lacks MCP support, you may need to use an alternative workflow or wrapper to reach the MCP-enabled server.

Available tools

Use these tools to interact with DiskCleanKit through the MCP server.

• one_touch_scan: Scan for junk files (safe, no deletion)

• one_touch_clean: Recommended — Scan AND clean junk files automatically

• get_disk_status: Check disk space and health status

• get_cleanable_estimate: Estimate cleanable space by category

• get_cleaning_history: View past cleaning sessions

What gets cleaned

The one_touch_clean tool automatically scans and removes only safe items. It cleans system and application caches and logs, which are regenerable by the system.

Usage examples

Once configured, you can trigger actions from your AI assistant as follows.

• Say: Scan my Mac for junk files — triggers one_touch_scan

• Say: Clean up my Mac — triggers one_touch_clean

• Say: How much disk space do I have? — triggers get_disk_status

• Say: What can be cleaned? — triggers get_cleanable_estimate

• Say: Show my cleaning history — triggers get_cleaning_history

How it works

The AI assistant communicates with the MCP server, which relays requests to DiskCleanKit using the diskcleankit:// URL scheme. DiskCleanKit writes the response to a temporary file, and the MCP server returns the result back to the AI assistant.

Security

All processing happens locally on your Mac. Neither personal documents nor data leave your device. Only saferegenerable caches and logs are touched, and the operations are designed to be safe.

Troubleshooting

If you encounter a timeout waiting for a response, ensure DiskCleanKit is installed and try opening DiskCleanKit manually first. If the server does not appear in Claude, confirm the correct configuration path and restart the client after changes, then check for errors in client logs.

License

MIT

Links

DiskCleanKit App and MCP Protocol resources are available for reference and setup guidance.

Available tools

one_touch_scan

Scan for junk files (safe, no deletion)

one_touch_clean

Scan AND clean junk files automatically (recommended)

get_disk_status

Check disk space and health status

get_cleanable_estimate

Estimate cleanable space by category

get_cleaning_history

View past cleaning sessions