Desktop Commander Model Context Protocol Server Grants Claude Terminal and File Controls
Desktop Commander open-sources a local Model Context Protocol server that enables secure filesystem search, live terminal controls, and native document editing.
Impact: High
Why it matters
You can now run interactive terminal processes, read Excel spreadsheets natively, and review edits live within Claude Desktop.
TL;DR
- 01Adds native reading and writing of PDF, DOCX, and Excel files to your AI interactions.
- 02Prevents token-cost blowouts by paginating long-running terminal process outputs.
- 03Supports sandboxed Docker installation to protect host system files from unintended deletions.
Key facts
- Supported File Formats
- .xlsx, .xls, .xlsm, .pdf, .docx, .csv, .json
- Update Mechanism
- Automatic updates on Claude restart (NPX option)
Complete System Access for Claude Desktop
Desktop Commander MCP provides a rich set of tools allowing Claude to execute long-running commands, manage local background processes, and stream paginated terminal stdout. It features a file preview UI supporting rendered Markdown, inline images, and quick file opening shortcuts.
Interactive Processes and Sandboxing
With this server, Claude can interact with active ssh sessions, databases, and local development servers. For safe local execution, it supports multiple installation options, including a persistent Docker setup that runs the entire toolset in an isolated container.
To configure the server manually for Claude Desktop on macOS, update your claude_desktop_config.json at ~/Library/Application Support/Claude/claude_desktop_config.json with the following block:
{
"mcpServers": {
"desktop-commander": {
"command": "npx",
"args": [
"-y",
"@wonderwhy-er/desktop-commander@latest"
]
}
}
}Try it in 2 minutes
npx @wonderwhy-er/desktop-commander@latest setupbash
✓ When to use
- To let Claude run build scripts, watch development servers, or interact with databases directly.
- When you need an agent to quickly analyze local sheets and generate formatted DOCX reports.
✕ When NOT to use
- When running Claude on a remote host where local npx or Docker setup is restricted.
- If you do not have permission to modify Claude Desktop config files.
What to do today
- Run the automated setup by executing 'npx @wonderwhy-er/desktop-commander@latest setup' in your terminal
- Add a list of restricted directories or terminal tools to the command blocklist for security
- Restart Claude Desktop to load the new MCP configuration successfully
Sources