Desktop Commander MCP Server

Use Desktop Commander MCP to read and edit local files, run terminal commands and inspect process output from an MCP client.

Local serverstdioTypeScript

What is the Desktop Commander MCP Server?

Desktop Commander connects an MCP assistant to local files and terminal processes. It supports reading and editing documents, starting commands and inspecting the output of running sessions. The local npm package runs on Node.js.

Investigate a local development task

Name the working directory and the result you need. The assistant can inspect relevant files, start a development command and read its output before proposing an edit. Keep the command and observed result with the explanation so the same investigation can be repeated.

Install the documented local server

The current package manifest requires Node.js 22.12.0 or later. Register npx -y @wonderwhy-er/desktop-commander@latest as a stdio server. The repository also describes a separate Remote Device flow for web clients. Its allowedDirectories setting applies to file operations; terminal commands are not confined to those directories.

Setup and tool documentation. Explore related MCP servers.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
read_fileRead a local file.
write_fileWrite file content.
start_processStart a terminal process.
read_process_outputRead output from a running session.
get_configInspect server configuration.

How to install the Desktop Commander MCP Server

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander@latest"
      ]
    }
  }
}

Configuration

Node.js 22.12.0 or later, as declared by the current package manifest. See the repository for Docker and Remote Device alternatives.

Example prompts to try

  • “Inspect this project directory and run its documented development command, then show the resulting process output.”

Frequently asked questions

The current npm package manifest specifies Node.js 22.12.0 or later.