MCPgee
MCPgee
MCPgeeMCPgee

Winremote

v1.0.0•Browser Automation•stable

Windows Remote MCP Server — 40+ tools for desktop automation, process management, file operations via FastMCP

agentautomationclaudemcpmodel-context-protocol
Share:
122
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Winremote?

Winremote is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to windows remote mcp server — 40+ tools for desktop automation, process management, file operations via fastmcp

Windows Remote MCP Server — 40+ tools for desktop automation, process management, file operations via FastMCP

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Windows Remote MCP Server — 40+ tools for desktop automation

Use Cases

Desktop process management
File operations automation
Windows system control
dddabtc

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx winremote

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Winremote

WinRemote MCP is a Python-based MCP server that turns any Windows machine into a remotely controllable automation endpoint, exposing 40+ tools for screenshots, PowerShell/CMD execution, file transfer, GUI automation (click, type, drag), process management, OCR, and screen recording. Built with FastMCP, it runs a local HTTP server on port 8090 and integrates with Claude Desktop, Cursor, Hermes, and OpenClaw. It is ideal for AI agents that need to interact with Windows desktops programmatically without leaving their MCP client.

Prerequisites

  • Windows machine with Python 3.9+ installed
  • pip package manager available
  • An MCP-compatible client (Claude Desktop, Cursor, Hermes, OpenClaw, etc.)
  • For remote access: a network connection between client and Windows machine, and an auth key
1

Install winremote-mcp from PyPI

Install the package on the Windows machine you want to control. This provides the winremote-mcp command-line entry point.

pip install winremote-mcp
2

Start the MCP server (local mode)

Run the server locally. By default it binds to 127.0.0.1:8090, which is safe for single-machine use. The server exposes a streamable HTTP endpoint at /mcp.

winremote-mcp
3

Start for remote access with authentication

For LAN or remote access, bind to all interfaces and supply an auth key. As of v0.4.20 the server refuses non-loopback binding without authentication.

winremote-mcp --host 0.0.0.0 --port 8090 --auth-key YOUR_SECRET_KEY
4

Configure auto-start on boot (optional)

Register winremote-mcp as a Windows service so it starts automatically when the machine boots.

winremote-mcp install
5

Add to your MCP client configuration

For Claude Desktop using local stdio, or for remote HTTP access from another machine, add the appropriate config block to your client's config file.

{
  "mcpServers": {
    "winremote": {
      "type": "http",
      "url": "http://192.168.1.100:8090/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SECRET_KEY"
      }
    }
  }
}

Winremote Examples

Client configuration

Remote HTTP configuration for Claude Desktop connecting to a Windows machine over LAN.

{
  "mcpServers": {
    "winremote": {
      "type": "http",
      "url": "http://192.168.1.100:8090/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SECRET_KEY"
      }
    }
  }
}

Prompts to try

Example prompts that exercise WinRemote's desktop automation, file, and process management tools.

- "Take a screenshot of the current desktop and describe what is on screen"
- "Run the PowerShell command Get-Process and list the top 10 processes by CPU usage"
- "Open Notepad, type 'Hello from Claude', and save the file as hello.txt on the Desktop"
- "List all running processes and kill the one named 'example.exe'"
- "Extract the text visible in the top half of the screen using OCR"

Troubleshooting Winremote

Server refuses to start with --host 0.0.0.0 and no auth key

As of v0.4.20, remote binding requires --auth-key. Add --auth-key YOUR_SECRET_KEY to the startup command, or use --allow-insecure-remote only in isolated lab environments.

GUI automation clicks land in the wrong position

Ensure the target application window is not minimized or occluded. WinRemote's coordinate system is based on the primary monitor at its native resolution; high-DPI scaling may require adjusting coordinates.

Connection times out when accessing from another machine

Verify that Windows Firewall allows inbound TCP on port 8090. Add a rule with: netsh advfirewall firewall add rule name="WinRemote MCP" protocol=TCP dir=in localport=8090 action=allow

Frequently Asked Questions about Winremote

What is Winremote?

Winremote is a Model Context Protocol (MCP) server that windows remote mcp server — 40+ tools for desktop automation, process management, file operations via fastmcp It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Winremote?

Follow the installation instructions on the Winremote GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Winremote?

Winremote works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Winremote free to use?

Yes, Winremote is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Winremote Alternatives — Similar Browser Automation Servers

Looking for alternatives to Winremote? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.

Chrome DevTools MCP

★ 40.6k

AI-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.8k

A 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.0k

JavaScript in-page GUI agent. Control web interfaces with natural language.

Chrome

★ 11.7k

An 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.8k

The 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.

Browser AutomationBrowse All Servers

Quick Config Preview

{ "mcpServers": { "winremote": { "command": "npx", "args": ["-y", "winremote"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Winremote?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides