# diskdiet MCP server

> Lets an AI client scan developer disk usage and safely remove old package caches, Docker images, and unused node_modules.

- Repository: https://github.com/roystondwork-dev/diskdiet
- Page: https://hostedmcp.org/servers/roystondwork-dev/diskdiet
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.7.1

## Install

### Claude Code

```sh
claude mcp add diskdiet -- npx -y diskdiet
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "diskdiet": {
      "command": "npx",
      "args": [
        "-y",
        "diskdiet"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "diskdiet": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "diskdiet"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "diskdiet": {
      "command": "npx",
      "args": [
        "-y",
        "diskdiet"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.diskdiet]
command = "npx"
args = ["-y", "diskdiet"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "diskdiet": {
      "command": "npx",
      "args": [
        "-y",
        "diskdiet"
      ]
    }
  }
}
```

## FAQ

### How does the MCP server work with AI assistants?

The server provides tools that allow assistants like Claude Code or Cursor to see what is using disk space and free it upon request.

### Is it safe to use diskdiet to free space?

Yes, it scans first and asks for confirmation before removing anything, and it ensures removals stay within designated cache folders.

### What happens to my projects after cleaning?

Anything removed from a cache is downloaded again when needed, and removed node_modules can be restored with a standard install command.