Desktop Commander MCP
MCP server that lets AI clients run terminal commands, manage processes, and search and edit files on the local machine.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 9 known high or critical vulnerabilities in the packages a fresh install brings (OSV.dev, 16 Nov 2026). Weigh this before you install it.
npm:node-forge 1.4.0Forge: X.509 basicConstraints bypass in verifyCertificateChain() via deprecated extension OIDs 2.5.29.10 and 2.5.29.13 (GHSA-5x38-2vff-x55p, high, fixed in 1.4.1)npm:zod 3.25.76Zod can exhaust memory while validating oversized constrained collections (GHSA-mrhx-c7xc-m3w5, high, fixed in 4.6.6)
See 7 more
npm:node-forge 1.4.0— GHSA-6qrw-m8cv-hcxf (high), fixed in 1.4.1npm:node-forge 1.4.0— GHSA-7wch-p9px-956x (high), fixed in 1.4.1npm:node-forge 1.4.0— GHSA-86w9-cpqp-85rv (high), no fix yetnpm:node-forge 1.4.0— GHSA-8hrf-8g6f-7xwp (high), fixed in 1.4.1npm:node-forge 1.4.0— GHSA-hqq3-7jhf-c5jx (high), fixed in 1.4.1npm:node-forge 1.4.0— GHSA-jc66-7q78-782g (high), fixed in 1.4.1npm:node-forge 1.4.0— GHSA-rhr8-3pm8-cq29 (high), fixed in 1.4.1
Linux x86_64
You need first
- Runtimes:
Node.js
npm install -g @wonderwhy-er/desktop-commander@latest (puts desktop-commander on PATH)
npm install -g @wonderwhy-er/desktop-commander@latest
Add it to your agent
claude mcp add desktopcommandermcp -- desktop-commanderJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"desktopcommandermcp": {
"command": "desktop-commander",
"args": []
}
}
}Add desktop-commander as an MCP server in your AI client's settings, then ask the AI to run a command or work with files.
What it does
- Run terminal commands and control running processesTested
How to use it
- Ask your AI client to run a command, which uses the
start_processtool with your command and a timeout. - Read the command's output in the tool's reply.
- Ask your AI client to run a command, which uses the
- Run Python, Node.js and R codeTested
How to use it
- Ask your AI client to run code, which uses the
start_processtool with a command such aspython3 -c "<your code>". - Read the result in the tool's reply.
- Ask your AI client to run code, which uses the
- Search files and make precise editsTested
How to use it
- Ask your AI client to change text in a file, which uses the
edit_blocktool. - Give the file path, the exact text to replace, and the new text.
- Ask your AI client to change text in a file, which uses the
- Read and edit Excel, PDF and DOCX filesNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 3 of 4 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- analyze a CSV file with Python via an AI chat
- keep an SSH session to a server and check disk space
- run an interactive Node session to test an API
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 15 Nov 2026
- Version 0.3.3
An MCP client handshake over stdio listed 25 tools, and a call to start_process returned a result.
Differences the test machine hit
- README: Option 1: npx @wonderwhy-er/desktop-commander@latest setup
In the test: That command only writes Claude Desktop config. To get a launch command on PATH I used npm install -g @wonderwhy-er/desktop-commander@latest, which installs the `desktop-commander` binary. - README: Native Excel file support / PDF support (no mention of a startup delay)
In the test: Excel and PDF support load lazily after the server starts. A tools/call sent right after initialize returns 'Error: Can't read in.xlsx yet: Desktop Commander is still loading its Excel support ... Try again in a few seconds.' A client has to wait or retry.