Use DiskDog with AI assistants (MCP)

The DiskDog MCP server is a small, standalone program that exposes DiskDog's scanning tools to AI assistants via the Model Context Protocol (MCP). Once configured, you can ask your assistant things like "what's filling up my C drive?" and it will call DiskDog's tools to answer.

Step 1 — Download the MCP server

1. 1Download the MCP server binary from the MCP page (or build it from source).
2. 2Save it somewhere stable, e.g. C:\Tools\diskdog-mcp.exe. Note the full path.

Step 2 — Configure your client

Add DiskDog to your MCP client config. The command must point to the binary path. On Windows, use double backslashes in the path.

Claude Desktop — edit claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "diskdog": {
      "command": "C:\\Tools\\diskdog-mcp.exe",
      "args": []
    }
  }
}

Kiro — edit .kiro/settings/mcp.json (workspace) or ~/.kiro/settings/mcp.json (global). You can auto-approve the read-only tools so they run without a prompt:

{
  "mcpServers": {
    "diskdog": {
      "command": "C:\\Tools\\diskdog-mcp.exe",
      "args": [],
      "disabled": false,
      "autoApprove": [
        "list_disks", "disk_health", "scan_junk",
        "scan_top_files", "scan_empty_files",
        "scan_empty_folders", "find_copies", "get_diskdog_app"
      ]
    }
  }
}

Step 3 — Restart and use

1. 1Restart your client (Claude Desktop) or reconnect the server (Kiro MCP panel). The DiskDog tools appear automatically.
2. 2Ask in natural language and the assistant picks the right tool.

Example prompts

• "List the usage of all my disks." → list_disks
• "Find the 20 largest files under D:\Downloads." → scan_top_files
• "What junk files can I clean up?" → scan_junk
• "Find copies of this photo across my drives." → find_copies
• "Are there empty folders under C:\Projects?" → scan_empty_folders
• "Check my disk health." → disk_health

Available tools

• list_disks — capacity, usage and filesystem of every drive.
• disk_health — SMART data: wear, temperature, power-on hours.
• scan_junk — temp files, caches, logs and build artifacts by category.
• scan_top_files — the largest files under a folder.
• scan_empty_files / scan_empty_folders — find empty files and folders.
• find_copies — locate identical or similar copies of a file.
• get_diskdog_app — info and download link for the full desktop app.

Troubleshooting

• Tools don't appear: double-check the command path is absolute and uses double backslashes on Windows, then fully restart the client.
• Double-clicking the .exe does nothing: that is expected. It is a stdio server with no window — it only runs when launched by an MCP client.
• A scan returns an error for a path: make sure the path exists and you have permission to read it.