Desktop Commander MCP Server

Work with code and text, run processes, and automate tasks, going far beyond other AI editors - while using host client subscriptions instead of API token costs. Its 25 documented tools cover process, file, directory. It runs locally over stdio via the published package.

People who work with process, file and directory and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-17 · ★ 9,633 · #2 OF 229 MAINTAINED CODING AGENT · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Desktop Commander

Claude Code

claude mcp add wonderwhy-er-desktopcommandermcp -- npx -y @wonderwhy-er/desktop-commander

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @wonderwhy-er/desktop-commander - published under the repo owner's npm scope (@wonderwhy-er)

registry namespace io.github.wonderwhy-er is GitHub-verified and matches the repo owner

03 · What Desktop Commander can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can start programs with smart detection of when they're ready for input, send commands to running programs and get responses, read output from running processes, and list all active terminal sessions.

Capability map

Tools grouped from the project's README - what Desktop Commander lets an agent do.

read & search

7 tools - e.g. List all active terminal sessions; List all running processes with detailed information; Read multiple files simultaneously

list_sessions · list_processes · read_multiple_files · get_more_search_results · list_searches · get_usage_stats…

Process

4 tools - e.g. Start programs with smart detection of when they're ready for input; Send commands to running programs and get responses; Read output from running processes

start_process · interact_with_process · read_process_output · kill_process

File

4 tools - e.g. Read contents from local filesystem, URLs, Excel files (.xlsx, .xls, .xlsm), and PDFs with line/page-based pagination; Write file contents with options for rewrite or append mode. Supports Excel files…

read_file · write_file · move_file · get_file_info

Config

2 tools - e.g. Get the complete server configuration as JSON (includes blockedCommands, defaultShell, allowedDirectories, fileReadLineLimit, fileWriteLineLimit, telemetryEnabl; Set a specific configuration value by key.…

get_config · set_config_value

Directory

2 tools - e.g. Create a new directory or ensure it exists; Get detailed recursive listing of files and directories (supports depth parameter, default depth=2)

create_directory · list_directory

run & execute

2 tools - e.g. Start streaming search for files by name or content patterns (searches text files and Excel content); Stop an active search gracefully

start_search · stop_search

Force

1 tool - e.g. Force terminate a running terminal session

force_terminate

create & write

1 tool - e.g. Create new PDF files from markdown or modify existing PDFs (insert/delete pages). Supports HTML/CSS styling and SVG graphics

write_pdf

Limitations (from the README)

> For comprehensive security information and vulnerability reporting: See SECURITY.md 1. Known security limitations: Directory restrictions and command blocking can be bypassed through various methods including symlinks, command substitution, and absolute paths or code execution

Latest releases

v0.2.51 · 2026-09-17

attribute which transport actually delivered eac… · drop redundant GoTrue getUser calls from the device connector · stop sending the result broadcast; revert #648 · fail an in-flight call when the local child dies, not…

v0.2.50 · 2026-09-09

Remove uninstall feedback call offer · Fix codespell tasklist false positive · Fix config overwriting in multiple dekstop commander process situation · stop sending character_codes from fuzzy search · stop a bad spawn…

v0.2.48 · 2026-09-02

persist the session by default · stop the realtime socket downgrading to the anon key · correct clock skew and half-open socket wedges · remove dead legacy postgres_changes transport · Feat/release workflow · parse…

In the wild · how people use Desktop Commander

Public posts that name a concrete use case. Linked source posts - not MCPhq reviews, ratings, or endorsements.

04 · Who maintains Desktop Commander

Desktop Commander is maintained by wonderwhy-er. It's the only MCP server we track from this author; the repo dates to Dec 2024.

05 · Facts

repository
github.com/wonderwhy-er/desktopcommandermcp
category
coding agent - ranked #2 of 229 actively-maintained coding agent servers as of 2026-09-18.
release cadence
5 releases in the last 90 days (latest 2026-09-17)
registry
io.github.wonderwhy-er/desktop-commander (active, first published 2025-09-12 · 33 versions)
packages
npm:@wonderwhy-er/desktop-commander

06 · Desktop Commander FAQ

Is Desktop Commander still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-17 and it shipped 5 releases in the last 90 days. We re-verify nightly.

What can Desktop Commander do?

With this server connected, an agent can start programs with smart detection of when they're ready for input, send commands to running programs and get responses, read output from running processes, and list all active terminal sessions.

How do I install Desktop Commander?

Run `npx -y @wonderwhy-er/desktop-commander`. You can also paste the ready-made client config above.

Does Desktop Commander run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Desktop Commander

Alternatives to Desktop Commander

Maintained coding agent servers if Desktop Commander isn't the fit.

  1. Serena A powerful toolkit for coding, providing semantic retrieval and editing capabilities. ★ 29,556 · 2026-09-17
  2. Ouroboros Pins an acceptance spec; the verify command and expected output never enter the success contract. ★ 6,016 · 2026-09-15
  3. Socraticode MCP server for enterprise local codebase indexing, semantic search, and code dependency graphs. ★ 3,312 · 2026-09-17
  4. Omnara Deploy durable AI agents with Omnara, an open-source managed-agent platform. ★ 2,858 · 2026-09-18
  5. Docs Search and read Empryo's documentation. Read-only, no auth, no local access. ★ 1,246 · 2026-09-17
  6. Magic Cloud Generate secured CRUD APIs over your database, run SQL, manage files, tasks and a headless browser ★ 1,193 · 2026-09-18

Pairs well with

Servers that cover what Desktop Commander doesn't - only shown when the pairing reason fits the companion.

  1. Context7 → documentation companion documentation · ★ 62,152
  2. GitLab MCP → documentation companion documentation · ★ 1,984
  3. Xcode Build MCP → developer tools companion developer tools · ★ 6,397
  4. Sentry MCP → developer tools companion developer tools · ★ 855
  5. Server Filesystem → filesystem companion filesystem · ★ 39,038
  6. Pdf MCP → filesystem companion filesystem · ★ 135

head to head · Serena vs Desktop Commander · LLM Sandbox vs Desktop Commander · Ouroboros vs Desktop Commander

More coding agent MCP servers · Gopls MCP · Nexusmem · Inspectrum · Skeletongraph · Polis Protocol

More TypeScript MCP servers · Wopee MCP · Th Memory MCP · Chestnyi Znak MCP Server · Max Messenger · Ozon Seller MCP Server · see all