Two ways in: a skill or MCP
Either way, the AI app runs SwitchDesk on your computer with your words for the other computer, and SwitchDesk works out which one you mean, from its name, an alias you gave it, or a close match. If two computers match, the AI asks you which one. It can also list your computers and show where the desk is, without moving anything.
- A skill is a short text file that tells an AI app when and how to run a command. It suits AI apps that work in a terminal or an editor: Claude Code, Codex, Copilot, Cursor, Gemini CLI.
- MCP lets an AI app start SwitchDesk itself and use it as a set of tools. It is the only way in for Claude's desktop app, and works in most of the others too. The app asks you before each switch.
Where both work, pick one: with both, the AI sees two ways to do the same thing.
A switch takes your keyboard and mouse away. Once it goes through, you are typing on the other computer, so the AI on this one can't hear from you until you switch back.
Nothing goes over the internet: the AI app runs SwitchDesk on this computer, and SwitchDesk talks to your desk directly.
Which AI apps can use it
| AI app | Skill | MCP |
|---|---|---|
| Claude Code (terminal, desktop app, editors) | Yes, from ~/.claude/skills | Yes |
| Claude desktop app, chat | No | Yes |
| Codex (CLI, editor extension, app) | Yes, from ~/.agents/skills | Yes |
| GitHub Copilot (CLI and VS Code) | Yes, from ~/.agents/skills or ~/.copilot/skills | Yes |
| Cursor | Yes, from ~/.agents/skills or ~/.claude/skills | Yes |
| Gemini CLI | Yes, from ~/.agents/skills or ~/.gemini/skills | Yes |
| Claude on the web or phone, ChatGPT chat | No | No: they only reach MCP servers on the internet, not programs on your computer. |
~ is your home folder: /Users/you on a Mac, C:\Users\you on Windows.
First, install SwitchDesk
Get it from the download page and set up your computers. On a Mac, keep it in Applications.
On Windows, for the skill, the AI app finds SwitchDesk.exe by name, so its folder must be on your PATH. In PowerShell, in the folder where SwitchDesk.exe is:
Add the skill
On a Mac, in Terminal. This puts the skill in both folders, so every AI app in the table finds it:
On Windows, in PowerShell:
Or download SKILL.md and put it in a folder called switch-desk inside the folder your AI app reads. It's plain text, so you can read it first.
Then start a new session in your AI app and ask it to “switch to my PC”, or whatever you called that computer. In Claude Code, /switch-desk my pc does the same. Claude Code runs the skill's two commands without asking, because the skill allows exactly those; other AI apps ask before they run a command unless you have told them not to.
Add the MCP server
The AI app starts SwitchDesk with --mcp. On a Mac the program is /Applications/SwitchDesk.app/Contents/MacOS/SwitchDesk; on Windows it is SwitchDesk.exe wherever you put it. In the examples below, put your Windows path in place of the Mac one, with each \ doubled inside JSON ("C:\\Tools\\SwitchDesk.exe").
It gives the AI three tools: list_computers, desk_status and switch_to.
Claude desktop app: Settings, Developer, Edit Config opens claude_desktop_config.json. Add this, then quit and reopen the app:
If the file already has an mcpServers section, add the switchdesk part inside it.
Claude Code, in a terminal:
Codex, in a terminal (the Codex app and editor extension share its settings):
Cursor: the same mcpServers section as for the Claude desktop app, in ~/.cursor/mcp.json.
Gemini CLI: the same mcpServers section, in ~/.gemini/settings.json.
VS Code with Copilot: in the Command Palette, MCP: Open User Configuration, then add:
Copilot CLI: /mcp add asks for the command and its arguments.
If it doesn't work
- The AI doesn't see SwitchDesk: for MCP, restart the AI app after adding the server, and check that the path to SwitchDesk is exact.
- The AI says it has no such skill: start a new session after adding the file, and check that the folder is named
switch-deskwithSKILL.mdinside. - “command not found” on Windows: the folder with
SwitchDesk.exeisn't on your PATH yet. Open a new terminal, or restart the AI app, after step 1. - The monitor moves but the keyboard and mouse don't: on a Mac, SwitchDesk needs Input Monitoring, in System Settings, Privacy & Security.
- “Unknown target”: the AI shows the computers SwitchDesk knows. Use one of those names, or add an alias in Settings, Computers.