You discuss a fix with ChatGPT, open files on your Mac mini, run a command, and paste the result back into the chat. Remote Desktop Commander (RDC) can reduce that back-and-forth.
Once RDC is connected, you can ask ChatGPT to inspect and edit files or run terminal commands on your Mac mini. This guide covers the connection, an initial test, and how to stop it when you are done.
Official documentation checked on October 4, 2026. Screens and access requirements may change. If what you see differs, check the latest instructions at the linked sources.
What can RDC do on a Mac mini?
RDC uses MCP, a protocol that connects AI to external tools. RDC's relay server receives instructions from ChatGPT and passes them to a small program running on your Mac mini. Results travel back to ChatGPT along the same path.
For example, it can find files in a specified folder, edit text, or run tests and investigate errors. ChatGPT handles the reasoning; the Mac mini handles the files and commands.
The standard tools mainly cover files, search, editing, and terminal operations. They do not provide general-purpose screen viewing and clicking in every app. Browser control may require separate tools or configuration. See the official README for the available tools.
1. Prepare your Mac mini and ChatGPT
You need a Mac mini you control, a ChatGPT account, and an RDC account. Keep the Mac mini powered on and connected to the internet. Once connected, RDC can modify files and run commands with the permissions of the Mac user running it, so start with a test folder containing no important data.
Open Terminal on the Mac and check whether Node.js and npm are available:
node --version
npm --versionIf they are missing or outdated, install a currently supported LTS release from the official Node.js website. RDC lists Node.js 18 or later as its minimum requirement, but there is no reason to install the now-unsupported Node.js 18 for a new setup.
2. Add Desktop Commander to ChatGPT
Open the official Desktop Commander page for ChatGPT and select “Add to ChatGPT” to add the plugin. If prompted to connect or sign in, review the information being shared and the requested permissions before proceeding.
If you cannot find the plugin, check ChatGPT's plugin guide. You can also register an MCP connection manually, but access requirements apply. Follow the official Developer mode instructions for that route.
3. Start RDC on the Mac mini and pair it
Run the following command in Terminal on your Mac mini. If the first run asks to download a package, check that its name matches before continuing.
npx @wonderwhy-er/desktop-commander@latest remote- Sign in on the RDC verification page that opens in your browser.
- Check that the pairing code in the browser matches the one in Terminal.
- If the codes match, select “Verify Device.”
- Check that Terminal reports it is ready and your Mac mini appears in the dashboard.
If the codes do not match, do not approve the pairing. Close the page and start again from the command. Use the same RDC account for the ChatGPT connection and the Mac pairing. You do not need to paste the code into chat.
With this startup method, keep Terminal open. Closing it disconnects RDC. The steps are also covered in the official setup guide.
4. Start by asking for file names only
Before using your usual development folder, create an empty test folder on the Mac mini and put one note containing no secrets inside it. Open a new chat in ChatGPT and use a request like this. Replace the bracketed text with your device name and folder path.
Use Desktop Commander to list only the file names directly inside [full path to the test folder] on the connected [Mac mini name]. Do not read the file contents, or modify or delete anything.
Check the returned device name and file names against your Mac mini. If they match, choose another empty folder and ask: “Create test.txt in this folder containing the text ‘Connection test’.” Open the file in Finder. If the contents match too, you have also verified that writing works.
For actual work, specify the target folder, what you want done, and what may be changed. For example, request an investigation of test results separately from a fix, so you can review the findings before deciding what to do next.
Understand the permissions and how to disconnect
Allowed-folder settings and command restrictions help reduce mistakes. They are not a sandbox that isolates RDC from the rest of your Mac. Choose a specific place to test, and avoid asking it to search your entire home folder or look for secrets.
Traffic is encrypted with TLS, but instructions and results pass through a relay server and are handled temporarily for delivery. Operational information is also collected, and tool-call history is recorded on the Mac. Do not assume everything stays on the Mac or that no records remain. Keep passwords and API keys out of chat, and protect both accounts with multi-factor authentication. See RDC's security documentation and the description of local history for details.
When you are finished, press Ctrl+C in the Terminal window running RDC. To revoke the device registration itself, open the RDC dashboard and select “Revoke” for that device.
What to check if the connection fails
- Device offline: check that the Mac mini is powered on and the Terminal window running RDC is still open.
- Device missing: check that the ChatGPT connection and Mac pairing use the same RDC account.
- Startup command fails: check that Node.js and npm report their versions.
Start by getting ChatGPT to return the file names from the folder you specified. For a related use of a Mac mini, see the article on running WordPress with a Mac mini and Xserver (in Japanese).
Related Articles
Read-Only AI Tasks: Separate Accounts and Permissions · English home