WinRemote MCP
The ultimate Windows MCP server for remote desktop control and automation. Control any Windows machine through the Model Context Protocol — perfect for AI agents, Claude Desktop, and OpenClaw integration. Transform your Windows desktop into a powerfu
What is WinRemote MCP?
WinRemote MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ultimate windows mcp server for remote desktop control and automation. control any windows machine through the model context protocol — perfect for ai agents, claude desktop, and openclaw integration....
The ultimate Windows MCP server for remote desktop control and automation. Control any Windows machine through the Model Context Protocol — perfect for AI agents, Claude Desktop, and OpenClaw integration. Transform your Windows desktop into a powerfu
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- The ultimate Windows MCP server for remote desktop control a
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx winremote-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use WinRemote MCP
WinRemote MCP is a Python-based MCP server that runs on a Windows machine and exposes full desktop control capabilities — screenshots, PowerShell/CMD execution, file transfer, GUI automation, OCR, and screen recording — over a local or remote HTTP connection secured with an API key. AI clients like Claude Desktop connect to it using the streamable-HTTP MCP transport, enabling AI agents to see, click, type, and execute commands on any Windows desktop as if they were physically present. It is the official Windows control layer for the OpenClaw agent framework and also works standalone with Claude Desktop.
Prerequisites
- A Windows machine (the machine to be controlled) with Python 3.9 or later
- pip for installing the winremote-mcp package from PyPI
- Claude Desktop or another MCP-compatible client on the controlling machine
- Network access between the client machine and the Windows machine (same LAN or VPN for remote use)
- An auth key string for securing remote connections (any secret string you choose)
Install winremote-mcp on the Windows machine
On the Windows machine you want to control, open a Command Prompt or PowerShell terminal and install the package from PyPI.
pip install winremote-mcpStart the MCP server
For local-only use, run without flags. For remote access from another machine, bind to all interfaces and set an auth key — this is required for any non-loopback address since v0.4.20.
# Local only (safest, loopback only)
winremote-mcp
# Remote access with authentication
winremote-mcp --host 0.0.0.0 --port 8090 --auth-key YOUR_SECRET_KEYOptionally configure auto-start on Windows boot
Register winremote-mcp as a Windows service so it starts automatically when the machine boots, without requiring a logged-in user.
winremote-mcp installConfigure Claude Desktop or another MCP client
On the client machine, add the WinRemote MCP endpoint to your MCP client configuration. Use the Windows machine's IP address and the auth key you chose.
Verify the connection
The server exposes its MCP endpoint at /mcp on the configured port. Confirm it is reachable from the client machine before starting a session.
# From the controlling machine, test reachability
curl http://<windows-ip>:8090/mcpWinRemote MCP Examples
Client configuration
Add this to claude_desktop_config.json on the client machine. Replace the IP, port, and auth key with your actual values.
{
"mcpServers": {
"winremote": {
"type": "streamable-http",
"url": "http://192.168.1.100:8090/mcp",
"headers": {
"Authorization": "Bearer YOUR_SECRET_KEY"
}
}
}
}Prompts to try
These prompts work once Claude Desktop is connected to a running winremote-mcp server on a Windows machine.
- "Take a screenshot of the Windows desktop and describe what you see."
- "Open Notepad, type 'Hello from Claude', and save the file to the Desktop."
- "Run 'Get-Process | Sort-Object CPU -Descending | Select-Object -First 10' in PowerShell and show me the output."
- "Download the file at https://example.com/data.csv and save it to C:\Users\me\Downloads\."
- "Extract the text visible in the top-right corner of the screen."Troubleshooting WinRemote MCP
Connection refused when the client tries to reach the Windows machine
Check that the Windows Firewall allows inbound TCP traffic on port 8090. Add an inbound rule in Windows Defender Firewall for the port, or temporarily disable the firewall to test.
Server refuses to start with '--host 0.0.0.0' without an auth key
Since v0.4.20, binding to a non-loopback interface requires --auth-key. Add '--auth-key YOUR_SECRET_KEY' to the startup command. Never use --allow-insecure-remote on a network-accessible machine.
GUI automation clicks land in the wrong position
Ensure the Windows display scaling is set to 100% (or that the server is aware of the DPI scaling factor). High-DPI scaling can offset click coordinates from what the screenshot coordinates show.
Frequently Asked Questions about WinRemote MCP
What is WinRemote MCP?
WinRemote MCP is a Model Context Protocol (MCP) server that ultimate windows mcp server for remote desktop control and automation. control any windows machine through the model context protocol — perfect for ai agents, claude desktop, and openclaw integration. transform your windows desktop into a powerfu It connects AI assistants to external tools and data sources through a standardized interface.
How do I install WinRemote MCP?
Follow the installation instructions on the WinRemote MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with WinRemote MCP?
WinRemote MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is WinRemote MCP free to use?
Yes, WinRemote MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
WinRemote MCP Alternatives — Similar Browser Automation Servers
Looking for alternatives to WinRemote MCP? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up WinRemote MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use WinRemote MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.