WinRemote MCP Server

WinRemote MCP — Run MCP Servers Remotely on Windows

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 powerful, remotely-accessible automation endpoint.

Run on the Windows machine you want to control. Built with FastMCP and the Model Context Protocol.

Quickstart (30 seconds)

# Install from PyPI
pip install winremote-mcp

# Start the Windows MCP server
winremote-mcp

That's it! Your Windows MCP server is now running on http://127.0.0.1:8090 and ready to accept commands from MCP clients like Claude Desktop or OpenClaw.

What's New in v0.4.8

• ✅ Added compatibility with fastmcp 3.x internal tool registry changes
• ✅ Kept compatibility with fastmcp 2.x
• ✅ Fixed tool wrapping/filtering paths that could raise: AttributeError: 'FastMCP' object has no attribute '_tool_manager'

What Problem It Solves

• Remote Windows Control: Control Windows desktops from anywhere through standardized MCP protocol
• AI Agent Integration: Enable Claude, GPT, and other AI agents to interact with Windows GUI applications
• Cross-Platform Automation: Bridge the gap between Linux/macOS development environments and Windows targets
• Headless Windows Management: Manage Windows servers and workstations without RDP or VNC overhead

Features

• Desktop Control — Screenshot capture (JPEG compressed, multi-monitor), click, type, scroll, keyboard shortcuts
• Window Management — Focus windows, minimize-all, launch/resize applications, multi-monitor support
• Remote Shell Access — PowerShell command execution with working directory support
• File Operations — Read, write, list, search files; binary transfer via base64 encoding
• System Administration — Windows Registry access, service management, scheduled tasks, process control
• Network Tools — Ping hosts, check TCP ports, monitor network connections
• Advanced Features — OCR text extraction, screen recording (GIF), annotated screenshots with UI element labels
• Security & Auth — Optional API key authentication, localhost-only binding by default

🤖 OpenClaw Integration

winremote-mcp works great with OpenClaw — providing full Windows desktop control as an MCP endpoint for AI agents.

Setup with OpenClaw

1. Start winremote-mcp on your Windows machine:

   pip install winremote-mcp
   winremote-mcp --port 8090
   

2. Configure OpenClaw to use it — add to your openclaw.json:

   {
     "plugins": {
       "entries": {
         "winremote": {
           "type": "mcp",
           "url": "http://<WINDOWS_IP>:8090/mcp"
         }
       }
     }
   }
   

3. That's it. Your AI agent can now:

   • Execute PowerShell/CMD commands on Windows
   • Take screenshots of the desktop
   • Transfer files between Linux and Windows
   • Control GUI applications
   • Access Windows-specific tools and APIs

No-Auth Mode (for trusted networks)

For home lab / LAN setups where authentication isn't needed:

winremote-mcp --port 8090 --no-auth

Note: winremote-mcp is a standard MCP server — it works with any MCP-compatible client, not just OpenClaw.

Installation

From PyPI (Recommended)

pip install winremote-mcp

From Source

git clone https://github.com/dddabtc/winremote-mcp.git
cd winremote-mcp
pip install .

With Optional Dependencies

# Install with OCR support (includes pytesseract)
pip install winremote-mcp[ocr]

# Install development dependencies
pip install winremote-mcp[test]

OCR Setup (Optional)

For text extraction from screenshots:

# 1. Install Tesseract OCR engine
winget install UB-Mannheim.TesseractOCR

# 2. Install with OCR dependencies
pip install winremote-mcp[ocr]

Usage

Basic Usage

Tier and tool controls

# Default: tier1 + tier2 enabled, tier3 disabled
winremote-mcp

# Enable destructive tier3 tools
winremote-mcp --enable-tier3

# Disable interactive tier2 (tier1 only)
winremote-mcp --disable-tier2

# Both together: tier1 + tier3 (tier2 disabled)
winremote-mcp --enable-tier3 --d