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.
T
TreeMap Disk Visualizer
Community
Visualize and reclaim disk space, safely.
GitHub source repository ↗
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.
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.
Tools
scan_path
Scan a folder and return a scanId for other tools.
get_largest
Get the largest files or folders in a scan.
find_duplicates
Find true duplicates (size + SHA-256 content hashing).
cleanup_suggestions
Get known-reclaimable space: caches, regenerable build folders, junk.
forecast
Forecast disk-full projection, e.g., 'full in ~58 days at current growth'.
compare_scans
Compare two scans to see what grew and what shrank.
offload
Move files to another drive safely: copy, verify, then trash originals.
trash_paths
Move files to the system trash, never a hard delete.
Setup
- 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"
]
}
}
}
Fit and risk
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.
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).
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 DesktopFull support
Claude CodeFull support
CursorFull support