winrdp-mcp — Claude Code MCP server: installation
winrdp-mcp is an MCP server for Claude Code that prepares and manages Windows hosts over WinRM, SSH, and SMB. It exposes RDP, file, service, and GUI controls.
MIT ★ 7 updated 2026-11-07
claude mcp add --env WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> --env WINRDP_PROFILE=<WINRDP_PROFILE> --transport stdio winrdp-mcp -- uvx winrdp-mcpWhat winrdp-mcp does
winrdp-mcp connects Windows machines and makes them manageable remotely. It can enable WinRM, adjust Windows Firewall rules, and handle local administrator token filtering. Its tools cover PowerShell, files, the registry, services, processes, scheduled tasks, users, event logs, networking, and interactive RDP desktop actions.
The controller can work with several hosts from one server, and the target does not need a preinstalled agent. Cold-start access through SMB/WMI requires the extra impacket package; when WinRM and SSH are unavailable, provision_host returns a one-time command for an RDP session. The operator machine needs Python 3.10+ and administrator credentials for the remote host.
What it helps with
- prepare a Windows host for remote administration
- run PowerShell or Python on a remote machine
- inspect and control Windows services, processes, and tasks
- take screenshots and operate an interactive RDP desktop
- check system health, open ports, and security events
Example prompts for the agent
- Add the host
vps1at203.0.113.10, then ask the server to prepare it withprovision_host. - Show the system details and run a PowerShell command that lists active services.
- Open the remote desktop, capture a screenshot, and click a named control through UI Automation.
How to install winrdp-mcp
Platform CLI
claude mcp add --env WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> --env WINRDP_PROFILE=<WINRDP_PROFILE> --transport stdio winrdp-mcp -- uvx winrdp-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from winrdp-mcp <command>
Platform CLI
codex mcp add winrdp-mcp --env WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> --env WINRDP_PROFILE=<WINRDP_PROFILE> -- uvx winrdp-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from winrdp-mcp <command>
Config file
{
"mcpServers": {
"winrdp-mcp": {
"command": "uvx",
"args": [
"winrdp-mcp"
],
"env": {
"WINRDP_VAULT_KEY": "<WINRDP_VAULT_KEY>",
"WINRDP_PROFILE": "<WINRDP_PROFILE>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from winrdp-mcp <command>
Config file
{
"servers": {
"winrdp-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"winrdp-mcp"
],
"env": {
"WINRDP_VAULT_KEY": "<WINRDP_VAULT_KEY>",
"WINRDP_PROFILE": "<WINRDP_PROFILE>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from winrdp-mcp <command>
Platform CLI
gemini mcp add -e WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> -e WINRDP_PROFILE=<WINRDP_PROFILE> winrdp-mcp uvx winrdp-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from winrdp-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 winrdp-mcp
How do I install winrdp-mcp in Claude Code?
Run claude mcp add winrdp-mcp -e WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> -- uvx winrdp-mcp. WINRDP_VAULT_KEY encrypts stored credentials at rest.
What does winrdp-mcp do?
It connects Windows hosts through WinRM, SSH, or SMB and gives Claude tools for command execution, files, services, the registry, RDP, and GUI automation. It can also prepare a host for remote management.
What does winrdp-mcp require?
The operator machine needs Python 3.10+ and administrator credentials for the Windows host. Cold-start setup over SMB/WMI uses the extra impacket package, and credential storage uses WINRDP_VAULT_KEY.