Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> --env WINRDP_PROFILE=<WINRDP_PROFILE> --transport stdio winrdp-mcp -- uvx winrdp-mcp
Open on GitHub

What 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 vps1 at 203.0.113.10, then ask the server to prepare it with provision_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-mcp

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>

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.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open