remote-pc-mcp — Claude Code MCP server: remote PC control
Gives an agent tools to run commands, handle files and control a remote desktop. Use it when an MCP client needs to work with another computer.
claude mcp add --env REMOTE_PC_MCP_TOKEN=<REMOTE_PC_MCP_TOKEN> --env REMOTE_PC_MCP_HOST=<REMOTE_PC_MCP_HOST> --env REMOTE_PC_MCP_PORT=<REMOTE_PC_MCP_PORT> --transport stdio remote-pc-mcp -- uvx remote-pc-mcpWhat remote-pc-mcp does
The server exposes tools for shell commands, file access, process management and system stats. An agent can also capture the desktop, click at screen coordinates or type into the focused window. Long-running commands can continue in the background, with output available by PID.
You need Python 3.10+ and either Windows 10/11 or Linux with systemd. Add the server to Claude Code with a token. Treat that token as a secret: shell_exec runs commands as the account that started the server, so a leaked credential grants command-line access under that account.
What it helps with
- run a shell command on a remote PC
- read or write a file on another machine
- check a background job by PID
- capture the desktop and interact with its UI
Example prompts for the agent
- Run
pwdon the connected PC and show me the output. - Read
config.jsonfrom the remote computer. - Take a screenshot of the remote desktop.
How to install remote-pc-mcp
Platform CLI
claude mcp add --env REMOTE_PC_MCP_TOKEN=<REMOTE_PC_MCP_TOKEN> --env REMOTE_PC_MCP_HOST=<REMOTE_PC_MCP_HOST> --env REMOTE_PC_MCP_PORT=<REMOTE_PC_MCP_PORT> --transport stdio remote-pc-mcp -- uvx remote-pc-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remote-pc-mcp <command>
Platform CLI
codex mcp add remote-pc-mcp --env REMOTE_PC_MCP_TOKEN=<REMOTE_PC_MCP_TOKEN> --env REMOTE_PC_MCP_HOST=<REMOTE_PC_MCP_HOST> --env REMOTE_PC_MCP_PORT=<REMOTE_PC_MCP_PORT> -- uvx remote-pc-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remote-pc-mcp <command>
Config file
{
"mcpServers": {
"remote-pc-mcp": {
"command": "uvx",
"args": [
"remote-pc-mcp"
],
"env": {
"REMOTE_PC_MCP_TOKEN": "<REMOTE_PC_MCP_TOKEN>",
"REMOTE_PC_MCP_HOST": "<REMOTE_PC_MCP_HOST>",
"REMOTE_PC_MCP_PORT": "<REMOTE_PC_MCP_PORT>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remote-pc-mcp <command>
Config file
{
"servers": {
"remote-pc-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"remote-pc-mcp"
],
"env": {
"REMOTE_PC_MCP_TOKEN": "<REMOTE_PC_MCP_TOKEN>",
"REMOTE_PC_MCP_HOST": "<REMOTE_PC_MCP_HOST>",
"REMOTE_PC_MCP_PORT": "<REMOTE_PC_MCP_PORT>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remote-pc-mcp <command>
Platform CLI
gemini mcp add -e REMOTE_PC_MCP_TOKEN=<REMOTE_PC_MCP_TOKEN> -e REMOTE_PC_MCP_HOST=<REMOTE_PC_MCP_HOST> -e REMOTE_PC_MCP_PORT=<REMOTE_PC_MCP_PORT> remote-pc-mcp uvx remote-pc-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remote-pc-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about remote-pc-mcp
How do I install remote-pc-mcp in Claude Code?
Run claude mcp add remote-pc-mcp -e REMOTE_PC_MCP_TOKEN=<REMOTE_PC_MCP_TOKEN> -- uvx remote-pc-mcp. To provide host and port settings as well, use `claude mcp add --env REMOTE_PC_MCP_TOKEN=<REMOTE_PC_MCP_TOKEN> --env REMOTE_PC_MCP_HOST=<REMOTE_PC_MCP_HOST> --env REMOTE_PC_MCP_PORT=<REMOTE_PC_MCP_PORT> --transport stdio remote-pc-mcp -- uvx remote-pc-mcp`.
What does remote-pc-mcp do?
It gives an MCP client tools for shell commands, files, processes, system stats and desktop interaction.
What does remote-pc-mcp require?
It needs Python 3.10+ and Windows 10/11 or Linux with systemd. Its token permits commands under the server account, so keep it private.
