How to add Desktop Commander to Cursor

Powerful local filesystem + terminal MCP server: search, diff-edit files, and run shell commands. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 15, 2026 · 6.2k★ · stdio · no auth

Cursor config for Desktop Commander

npx -y @wonderwhy-er/desktop-commander

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

Setup steps

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Desktop Commander config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Desktop Commander's tools to confirm it's connected.

Before you start

Node.js installed (required for the npx, bash-installer, and manual install paths)
Alternatively Docker, which runs the server without a local Node.js install
An MCP client such as Claude Desktop, Claude Code, or Cursor
No credentials or API key needed — auth is none, but it has full access to your local files and shell, so understand the security implications

What Desktop Commander can do in Cursor

start_process / interact_with_process / read_process_output

Launch a program with readiness detection, send it input, and read its output — supports interactive and REPL-style sessions.

force_terminate / list_sessions / list_processes / kill_process

Manage terminal sessions and OS processes: stop a session, list active sessions, list running processes, and kill by PID.

read_file / read_multiple_files

Read local files, URLs, Excel, and PDFs with pagination and negative-offset (tail-style) reads; batch-read several files at once.

write_file / write_pdf

Create or modify files, including Excel and PDF documents.

edit_block

Apply targeted text replacements to a file with a fuzzy-search fallback for precise, surgical edits.

create_directory / list_directory / move_file / get_file_info

Create directories, list directory contents recursively, move/rename files, and fetch file metadata.

start_search / get_more_search_results / stop_search

Run paged file and content searches across the filesystem.

get_config / set_config_value

Read and modify server configuration, including allowed directories, command blocklists, and telemetry settings.

Security

This server can execute arbitrary terminal commands and edit any file your user account can reach, so it effectively grants full machine access; only enable it for trusted sessions. There is no built-in directory sandbox like the reference filesystem server.

Desktop Commander + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Desktop Commander config there under the "mcpServers" key and restart the client.

Is Desktop Commander safe to use with Cursor?

Does it need an API key or login?

No. It runs locally with no authentication, but it has broad access to your filesystem and terminal, so treat it like giving an agent a shell on your machine.

How do I restrict what it can access?

Use `set_config_value` to configure allowed directories and command blocklists. You can also run it inside Docker for sandboxing, and it includes symlink-traversal prevention.

Does it send my data anywhere (telemetry)?

It collects limited pseudonymous telemetry that excludes file contents and command arguments. Disable it by setting `telemetryEnabled` to false in the config.

View repo Full Desktop Commander page