Skip to content
Back to search

remote-desktop-commander

Reach your own computer's filesystem and terminal from GitHub Copilot and VS Code — via Desktop Commander's hosted remote MCP server. Read and edit files, run terminal commands, and manage processes on machines you pair and control.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/desktop-commander--remote-desktop-commander/badge.svg)](/listings/desktop-commander--remote-desktop-commander)

HTML

<a href="/listings/desktop-commander--remote-desktop-commander"><img src="/api/listings/desktop-commander--remote-desktop-commander/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Start the device agent

On the computer you want to control:

npx @wonderwhy-er/desktop-commander@latest remote

Your browser opens to a verification page showing a pairing code (also printed in the terminal — a standard OAuth device-flow check). Sign in, confirm the codes match, and the terminal reports "Device ready". Keep the agent running: close the terminal, no access.

2. Connect your AI client

Each client walks you through OAuth sign-in on first connect.

**claude.ai / Claude Desktop** — Settings → Connectors → **Add custom connector**, then enter:

https://mcp.desktopcommander.app/mcp

**Claude Code:**

claude mcp add --transport http remote-desktop-commander https://mcp.desktopcommander.app/mcp

(If you work inside a checkout of this repo, Claude Code also picks up the included [`.mcp.json`](.mcp.json) automatically.)

**ChatGPT** — Settings → Apps & Connectors → Advanced settings → enable **Developer mode** (requires a plan that includes it), then **Create connector** and enter:

https://mcp.desktopcommander.app/mcp

**Cursor** — one click: [**Add to Cursor**](cursor://anysphere.cursor-deeplink/mcp/install?name=remote-desktop-commander&config=eyJ1cmwiOiAiaHR0cHM6Ly9tY3AuZGVza3RvcGNvbW1hbmRlci5hcHAvbWNwIn0=). Or add to `~/.cursor/mcp.json` manually:

{
  "mcpServers": {
    "remote-desktop-commander": {
      "url": "https://mcp.desktopcommander.app/mcp"
    }
  }
}

**VS Code** — install the agent plugin (bundles this server):

copilot plugin install desktop-commander/remote-desktop-commander

Or add the server directly to `.vscode/mcp.json` in your workspace (or your user-level `mcp.json`):

{
  "servers": {
    "remote-desktop-commander": {
      "type": "http",
      "url": "https://mcp.desktopcommander.app/mcp"
    }
  }
}

**Gemini CLI:**

gemini extensions install https://github.com/desktop-commander/remote-desktop-commander

**Antigravity:**

agy plugin install https://github.com/desktop-commander/remote-desktop-commander

Then open **Customizations → Installed → MCP Servers** and click **Authenticate** to sign in.

3. Try it

These work against any machine running the agent, no setup needed:

> "List the contents of my home directory and tell me what's there." > > "Create a folder called ai-test in my Documents folder. Inside it, write a short Python script that prints the date, and run it." > > "Start a Python REPL on my machine, import pandas, and tell me which version is installed. Keep the session alive." > > "Search my home directory for files modified in the last 24 hours and group them by folder."

Full walkthrough with troubleshooting: [docs/SETUP.md](docs/SETUP.md)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

plugin.json · Manifest · 21 lines
  1. {
  2. "name": "remote-desktop-commander",
  3. "description": "Reach your own computer's filesystem and terminal from GitHub Copilot and VS Code — via Desktop Commander's hosted remote MCP server. Read and edit files, run terminal commands, and manage processes on machines you pair and control.",
  4. "version": "1.1.30",
  5. "author": {
  6. "name": "Desktop Commander",
  7. "url": "https://desktopcommander.app"
  8. },
  9. "repository": "https://github.com/desktop-commander/remote-desktop-commander",
  10. "license": "SEE LICENSE IN LICENSE",
  11. "keywords": [
  12. "mcp",
  13. "remote",
  14. "terminal",
  15. "filesystem",
  16. "process",
  17. "automation",
  18. "desktop-commander"
  19. ],
  20. "mcpServers": ".mcp.json"
  21. }
README.md · README · 170 lines
  1. # Remote Desktop Commander
  2. ![Remote Desktop Commander](assets/logo-small.png)
  3. **Build, explore, automate on your computer — from anywhere.**
  4. Reach your computer's filesystem and terminal from any AI app that supports remote MCP connectors. Remote Desktop Commander is a hosted [MCP](https://modelcontextprotocol.io) server that relays a secure connection to your real machine, giving your AI assistant the same full file and shell access as the local server — without you needing to be at the keyboard.
  5. - **Server endpoint:** `https://mcp.desktopcommander.app/mcp` (Streamable HTTP, OAuth 2.0)
  6. - **Dashboard:** [mcp.desktopcommander.app](https://mcp.desktopcommander.app)
  7. - **Status:** currently in beta
  8. - **Demo:** [watch the video](https://youtu.be/C2kH5itFsGg)
  9. [![Add to Cursor](https://img.shields.io/badge/Add_to-Cursor-000000?style=for-the-badge&logo=cursor&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=remote-desktop-commander&config=eyJ1cmwiOiAiaHR0cHM6Ly9tY3AuZGVza3RvcGNvbW1hbmRlci5hcHAvbWNwIn0=)
  10. > This repository hosts the public manifests, documentation and issue tracker for the hosted service. The service implementation is not open source. For the open-source local (stdio) server, see [DesktopCommanderMCP](https://github.com/wonderwhy-er/DesktopCommanderMCP).
  11. ## What you can do
  12. - **Build from scratch** — create features and applications with simple commands
  13. - **Manage development environments** — set up servers, configure systems, handle processes
  14. - **Explore existing codebases** — navigate and understand complex repositories
  15. - **Edit documents in place** — work on Word, Excel, and PDF files where they live on disk
  16. - **Manage context and documentation** — keep track of project details and technical specifications
  17. - **Control multiple machines** — pair several computers and address them by name in one conversation
  18. ## Quick start
  19. ### 1. Start the device agent
  20. On the computer you want to control:
  21. ```bash
  22. npx @wonderwhy-er/desktop-commander@latest remote
  23. ```
  24. Your browser opens to a verification page showing a pairing code (also printed in the terminal — a standard OAuth device-flow check). Sign in, confirm the codes match, and the terminal reports "Device ready". Keep the agent running: close the terminal, no access.
  25. ### 2. Connect your AI client
  26. Each client walks you through OAuth sign-in on first connect.
  27. **claude.ai / Claude Desktop** — Settings → Connectors → **Add custom connector**, then enter:
  28. ```
  29. https://mcp.desktopcommander.app/mcp
  30. ```
  31. **Claude Code:**
  32. ```bash
  33. claude mcp add --transport http remote-desktop-commander https://mcp.desktopcommander.app/mcp
  34. ```
  35. (If you work inside a checkout of this repo, Claude Code also picks up the included [`.mcp.json`](.mcp.json) automatically.)
  36. **ChatGPT** — Settings → Apps & Connectors → Advanced settings → enable **Developer mode** (requires a plan that includes it), then **Create connector** and enter:
  37. ```
  38. https://mcp.desktopcommander.app/mcp
  39. ```
  40. **Cursor** — one click: [**Add to Cursor**](cursor://anysphere.cursor-deeplink/mcp/install?name=remote-desktop-commander&config=eyJ1cmwiOiAiaHR0cHM6Ly9tY3AuZGVza3RvcGNvbW1hbmRlci5hcHAvbWNwIn0=). Or add to `~/.cursor/mcp.json` manually:
  41. ```json
  42. {
  43. "mcpServers": {
  44. "remote-desktop-commander": {
  45. "url": "https://mcp.desktopcommander.app/mcp"
  46. }
  47. }
  48. }
  49. ```
  50. **VS Code** — install the agent plugin (bundles this server):
  51. ```bash
  52. copilot plugin install desktop-commander/remote-desktop-commander
  53. ```
  54. Or add the server directly to `.vscode/mcp.json` in your workspace (or your user-level `mcp.json`):
  55. ```json
  56. {
  57. "servers": {
  58. "remote-desktop-commander": {
  59. "type": "http",
  60. "url": "https://mcp.desktopcommander.app/mcp"
  61. }
  62. }
  63. }
  64. ```
  65. **Gemini CLI:**
  66. ```bash
  67. gemini extensions install https://github.com/desktop-commander/remote-desktop-commander
  68. ```
  69. **Antigravity:**
  70. ```bash
  71. agy plugin install https://github.com/desktop-commander/remote-desktop-commander
  72. ```
  73. Then open **Customizations → Installed → MCP Servers** and click **Authenticate** to sign in.
  74. ### 3. Try it
  75. These work against any machine running the agent, no setup needed:
  76. > "List the contents of my home directory and tell me what's there."
  77. >
  78. > "Create a folder called ai-test in my Documents folder. Inside it, write a short Python script that prints the date, and run it."
  79. >
  80. > "Start a Python REPL on my machine, import pandas, and tell me which version is installed. Keep the session alive."
  81. >
  82. > "Search my home directory for files modified in the last 24 hours and group them by folder."
  83. Full walkthrough with troubleshooting: [docs/SETUP.md](docs/SETUP.md)
  84. ## Requirements
  85. - Node.js 18 or newer (for `npx`) on each computer you want to control
  86. - One terminal running the device agent per machine
  87. - Works on **macOS, Windows, and Linux**
  88. ## Available tools
  89. | Category | Tools |
  90. |---|---|
  91. | **Read & explore** | Read File, Read Multiple Files, List Directory, Get File Info |
  92. | **Search** | Start Search, Get More Search Results, Stop Search, List Active Searches |
  93. | **Write & edit** | Write File, Edit File Block, Move or Rename File, Create Directory, Write or Modify PDF |
  94. | **Terminal & processes** | Start Process, Send Input to Process, Read Process Output, List Active Sessions, List System Processes, Terminate Session, Kill System Process |
  95. | **Devices & account** | List Paired Devices, Current User Info, Ping Device, Shutdown Device Agent |
  96. | **Configuration & help** | Get Configuration, Set Configuration Value, Get Prompt Library, Get Recent Tool Activity, Get Usage Statistics, Submit Feedback |
  97. ## How it works
  98. ```mermaid
  99. sequenceDiagram
  100. participant AI as AI app (web, mobile, desktop)
  101. participant S as mcp.desktopcommander.app
  102. participant D as Your computer (device agent)
  103. AI->>S: MCP tool call (OAuth 2.0 bearer)
  104. S->>D: relayed to your paired device
  105. D->>D: executes locally
  106. D->>S: result
  107. S->>AI: MCP response
  108. ```
  109. - Authentication is standard **OAuth 2.0 with PKCE**; devices pair via the OAuth **device authorization flow** (the short-code approval you see at setup).
  110. - The server only accesses data explicitly requested through tool calls; transmission is encrypted in transit (HTTPS/TLS).
  111. - A machine is reachable **only while its device agent is running** — stop it with `Ctrl+C` and access ends. Devices can also be reviewed and revoked at any time from the [dashboard](https://mcp.desktopcommander.app).
  112. - Tools execute with **your user account's permissions** on the paired machine, so treat your connected AI accounts like credentials and protect them with MFA. Read the full trust model in [SECURITY.md](SECURITY.md).
  113. ## Support & legal
  114. - **Setup guide:** [docs/SETUP.md](docs/SETUP.md)
  115. - **Bugs & feature requests:** [GitHub Issues](https://github.com/desktop-commander/remote-desktop-commander/issues) · **Contributing:** [CONTRIBUTING.md](CONTRIBUTING.md)
  116. - **Community:** [Discord](https://discord.gg/kQ27sNnZr7)
  117. - **Security reports:** see [SECURITY.md](SECURITY.md)
  118. - **Privacy policy:** [Remote Desktop Commander privacy policy](https://legal.desktopcommander.app/#/remote_privacy_policy) · **Terms of service:** [legal.desktopcommander.app](https://legal.desktopcommander.app/#/terms_of_service)
  119. - **License:** [LICENSE](LICENSE) — this repository holds docs and manifests only; the hosted service is proprietary
  120. ## Related
  121. - [DesktopCommanderMCP](https://github.com/wonderwhy-er/DesktopCommanderMCP) — the open-source local MCP server (npm: [`@wonderwhy-er/desktop-commander`](https://www.npmjs.com/package/@wonderwhy-er/desktop-commander)), which also ships the `remote` device agent used for pairing
  122. - [desktopcommander.app](https://desktopcommander.app) — product site

Version history

  • v1.1.3011/18/2026

  • v1.1.2911/16/2026

  • v1.1.2811/13/2026

  • v1.1.2511/11/2026

  • v1.1.2111/5/2026

  • v1.1.1610/30/2026

  • v1.1.1210/28/2026

  • v1.0.8010/23/2026

  • v1.0.7910/21/2026

  • v1.0.7510/18/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.