Diskcleankit MCP

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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)

Terminal

npm install -g @vannamtran/diskcleankit-mcp

From Source

bash

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):

config.json

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

Then restart Claude Desktop.

Claude Code (CLI)

Terminal

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

Or edit ~/.claude/settings.json:

config.json

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

Cursor

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

config.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:

config.json

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

Other MCP Clients

Client	Config File
Cline	VS Code extension settings
Windsurf	`~/.windsurf/mcp.json`
Zed	`~/.config/zed/settings.json`
Continue	`~/.continue/config.json`

Use the same configuration structure:

config.json

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

Ollama (via mcphost)

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

Terminal

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

Unsupported

ChatGPT: No native MCP support

Available Tools

Tool	Description
`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

one_touch_clean automatically scans and cleans safe items only:

Category	Description
System Caches	macOS system cache files
Application Caches	App-generated cache files
Application Logs	Old log files from apps
Browser Caches	Safari, 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

Code

AI Assistant → MCP Server → URL Scheme → DiskCleanKit App
                   ↑                            ↓
              JSON Response ← Temp File ← Response

AI calls MCP server tools
MCP server triggers DiskCleanKit via diskcleankit:// URL scheme
DiskCleanKit processes request and writes response to /tmp/diskcleankit_mcp_response.json
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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

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

Frequently Asked Questions about Diskcleankit MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "diskcleankit-mcp": { "command": "npx", "args": ["-y", "diskcleankit-mcp"] } }

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 Preview

Diskcleankit 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>

Technical Specs & Signals

CategoryDeveloper Tools

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Diskcleankit MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Diskcleankit MCP

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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)

Terminal

npm install -g @vannamtran/diskcleankit-mcp

From Source

bash

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):

config.json

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

Then restart Claude Desktop.

Claude Code (CLI)

Terminal

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

Or edit ~/.claude/settings.json:

config.json

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

Cursor

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

config.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:

config.json

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

Other MCP Clients

Client	Config File
Cline	VS Code extension settings
Windsurf	`~/.windsurf/mcp.json`
Zed	`~/.config/zed/settings.json`
Continue	`~/.continue/config.json`

Use the same configuration structure:

config.json

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

Ollama (via mcphost)

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

Terminal

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

Unsupported

ChatGPT: No native MCP support

Available Tools

Tool	Description
`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

one_touch_clean automatically scans and cleans safe items only:

Category	Description
System Caches	macOS system cache files
Application Caches	App-generated cache files
Application Logs	Old log files from apps
Browser Caches	Safari, 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

Code

AI Assistant → MCP Server → URL Scheme → DiskCleanKit App
                   ↑                            ↓
              JSON Response ← Temp File ← Response

AI calls MCP server tools
MCP server triggers DiskCleanKit via diskcleankit:// URL scheme
DiskCleanKit processes request and writes response to /tmp/diskcleankit_mcp_response.json
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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

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

Frequently Asked Questions about Diskcleankit MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "diskcleankit-mcp": { "command": "npx", "args": ["-y", "diskcleankit-mcp"] } }

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 Preview

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>

Technical Specs & Signals

CategoryDeveloper Tools

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity1/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Diskcleankit MCP →Install in Claude Desktop Install in Cursor Install in VS Code