WizTree MCP

日本語 | English

Read-only MCP server that wraps WizTree's CSV export and adds disk-usage analysis tools.

Windows-only in practice, because it depends on WizTree.

Tools

• locate_wiztree: Find a WizTree executable from WIZTREE_PATH, PATH, and common install locations.

• scan_path: Run WizTree CSV export for a drive or folder. Writes CSV snapshots under exports/.

• analyze_csv: Summarize an existing WizTree CSV snapshot.

• top_entries: List the largest files or folders from a CSV snapshot.

• extension_summary: Aggregate file usage by extension.

• compare_csv: Compare two CSV snapshots and report growth/shrinkage by path.

The server never deletes files. It only launches WizTree for export and reads generated CSVs.

Related MCP server: filesystem-mcp

Setup

Clone the repo, enter the repo folder, install dependencies, and build the TypeScript output.

git clone https://github.com/onmokoworks/wiztree-mcp.git
cd wiztree-mcp
npm install
npm run build

This produces dist/index.js, which is the file your MCP client should run.

MCP Config

Replace C:\\path\\to\\wiztree-mcp with the folder where you cloned this repo.

{
  "mcpServers": {
    "wiztree": {
      "command": "node",
      "args": ["C:\\path\\to\\wiztree-mcp\\dist\\index.js"],
      "env": {
        "WIZTREE_PATH": "C:\\Program Files\\WizTree\\WizTree64.exe"
      }
    }
  }
}

WIZTREE_PATH is optional if WizTree is installed in a common location or is on PATH.

For Codex, add the same server to C:\\Users\\<you>\\.codex\\config.toml:

[mcp_servers.wiztree]
command = 'node'
args = ['C:\path\to\wiztree-mcp\dist\index.js']
startup_timeout_sec = 120

[mcp_servers.wiztree.env]
WIZTREE_PATH = 'C:\Program Files\WizTree\WizTree64.exe'

After changing MCP configuration, restart the MCP client or open a new session so it reloads the server list.

Smoke Test

You can verify that the compiled server starts with:

node .\dist\index.js

The process waits for MCP JSON-RPC messages over stdio, so it will appear idle. Press Ctrl+C to stop it.

Privacy

WizTree CSV exports contain full local file and folder paths. This server writes exports to exports/ by default, and that directory is intentionally ignored by Git.

Before sharing logs, screenshots, or CSV files, check that they do not expose private project names, user names, or file paths.

Notes

• This server is read-only. It does not delete, move, or modify scanned files.

• Running WizTree with admin: true may trigger Windows elevation.

• The CSV parser supports both English and Japanese WizTree column headers.