TreeMap Disk Visualizer

Community

Visualize and reclaim disk space, safely.

How to install ↓ Compare GitHub source repository ↗

Category: Filesystem #7 of 24
Stars: ★ 810 Very popular
Transport: stdio (local process)
Runtime: Node.js 20+
Credentials: No credential needed
License: MIT
Last commit: 11 days ago
Tools: 8

62FMRS · C

TreeMap is a feature-rich disk analyzer with safe AI-driven cleanup via MCP. Its design prioritizes data safety: all deletions are recoverable, and AI is restricted to scanned paths. Ideal for users who want to manage their disk via conversation.

Strongest · Documentation 16/20 Weakest · Reliability 8/20

Reliability

8/20

Security and permissions

14/20

Maintenance

14/20

Documentation

16/20

Setup experience

10/20

Why each score

Reliability 8/20: The README describes a complete MCP server (stdio) with eight tools, but no MCP-specific tests or CI validating the handshake and tool list were found. The server path (dist/mcp/index.js) requires a build step, but no build output or explicit test evidence is present. Despite detailed API documentation and architecture, static review lacks verifiable execution evidence, so cap at 12.
Security and permissions 14/20: Security design is comprehensive: all deletions only move to system Trash, system critical directories are blocked, path guard and token-bucket rate limiting. MCP tools require prior scan, support dryRun, and agent-policy.json restrictions. Cloud scanning is opt-in and metadata-only, no file contents downloaded. However, no automated tests for security features found, and sensitive operations require user confirmation, but static evidence is insufficient to award full marks.
Maintenance 14/20: Repository is active with 420 stars and 0 open issues, but version release frequency or contributor activity not mentioned. MIT license and CI (GitHub Actions) presence (release workflow) but dependency update frequency or security response channels not checked. Overall good maintenance, but more granular evidence is lacking.
Documentation 16/20: README is extremely detailed, covering installation, MCP configuration (Claude Desktop, Claude Code, Cursor), API reference, safety notes, and design decisions. MCP tool list with examples provided. Missing troubleshooting section (build failures, dependency issues), and MCP section only mentions setup, no detailed parameter descriptions. Documentation is strong but could be improved.
Setup experience 10/20: MCP server requires Node 20+, clone, install, build, then configure client. Multiple client config examples provided, steps clear. However, manual build needed, and no pre-built MCP server release. Static review cannot verify installation process, but documentation provides sufficient guidance, so cap at 15.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local files

Best for

Users who want a real-time view of disk space distribution.
Users who want AI-assisted disk cleanup and data management.
Users needing a cross-platform (macOS, Windows, Linux) storage analyzer.

Not for

Users who need permanent deletion (rather than moving to trash).
Users who need content-level cloud scanning (metadata only).
Users who cannot install Node.js for MCP usage.

Required permissions

Read file and folder metadata (size, path, etc.).
Move files to the system trash (via OS APIs, recoverable).
Access system trash size.
Optionally listen on the LAN in a separate process (Fleet feature, off by default).

Risks and side effects

AI might accidentally trash important files, but deletions go to the system trash and can be manually restored.
AI may scan folders with sensitive information, but data is processed locally and not uploaded.
Cloud interactions are metadata-only; no file contents are downloaded.
Offload requires sufficient space on the target drive; failure rolls back safely.

Setup

Before you start

Runtime：Node.js 20+

Ensure Node.js 20+ is installed.
Clone the repository: git clone https://github.com/Prithvi-Web/TreeMap-Disk-Visualizer.git
Enter the directory: cd TreeMap-Disk-Visualizer
Install dependencies: npm install
Build: npm run build
In your MCP client (e.g., Claude Desktop), add the configuration above to mcpServers, replacing /PATH/TO/... with the actual path.
Restart the client.

claude_desktop_config.json

{
  "mcpServers": {
    "treemap": {
      "command": "node",
      "args": [
        "/PATH/TO/TreeMap-Disk-Visualizer/dist/mcp/index.js"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "treemap": {
      "command": "node",
      "args": [
        "/PATH/TO/TreeMap-Disk-Visualizer/dist/mcp/index.js"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add treemap -- node /PATH/TO/TreeMap-Disk-Visualizer/dist/mcp/index.js

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After building, Claude Desktop's tools icon should list eight tools under the treemap server (e.g. scan_path, get_largest); alternatively run npm run mcp in the repo and it should print server ready on stdio.

Troubleshooting

If MCP connection fails, check Node.js version (needs 20+).
Verify the /PATH/TO/ path is correct and dist/mcp/index.js exists.
Reload MCP configuration in your client or fully restart the app.
Check terminal for error output (try running `npm run mcp` to test).

Things to try

Once connected, you can ask your AI assistant things like:

Scan my Downloads folder and tell me what's eating my disk
Find duplicates in my home directory and show the reclaimable space per group
How long until this disk is full at the current growth rate?
Move my large videos to the external drive — do a dry run first

Tools 8

scan_path read-only

Scan a folder and return a scanId for other tools.

get_largest read-only

Get the largest files or folders in a scan.

find_duplicates read-only

Find true duplicates (size + SHA-256 content hashing).

cleanup_suggestions read-only

Get known-reclaimable space: caches, regenerable build folders, junk.

forecast read-only

Forecast disk-full projection, e.g., 'full in ~58 days at current growth'.

compare_scans read-only

Compare two scans to see what grew and what shrank.

offload destructive

Move files to another drive safely: copy, verify, then trash originals.

trash_paths destructive

Move files to the system trash, never a hard delete.

Use cases

"What's eating my disk?"

"Find duplicates in my Downloads and clean them up."

"How long until this disk is full?"

"Move my old videos to the external drive."

Supported clients

Claude Desktop

Claude Code

Cursor

Listed from the project's documentation, not tested by this site.

Overview

TreeMap is a cross-platform disk space visualizer that presents disk usage as charts and treemaps. Through MCP, AI assistants can scan folders, identify large files, find duplicates, suggest cleanup actions, forecast disk exhaustion, and safely move files to the system trash. All deletions are recoverable and subject to strict safety boundaries.

Similar servers

Filesystem MCP Server 84 · B

Secure local file read/write access

★ 91.2k · Tools 6 Compare with this →

Vault Cortex MCP Server 79 · B

Standalone MCP server for Obsidian vaults: hybrid search, notes & files, structured memory, tasks, OAuth 2.1.

★ 26 · Tools 30 Compare with this →

Obsidian Web MCP 68 · C

Secure remote access to your Obsidian vault over HTTPS with OAuth 2.0 authentication.

★ 183 · Tools 20 Compare with this →

Safe Docx MCP Server 68 · C

AI-native surgical editing of Word and OpenDocument files with formatting preservation

★ 46 Compare with this →

Compare with other MCP servers

Source revision 55b0312535d6 Data synced 2026-10-12 Read the FMRS scoring method