winremote-mcp

Overview

WinRemote-MCP is a comprehensive Windows remote control server built with FastMCP that exposes over 40 tools for automation and management. It enables AI agents to interact with Windows systems through screenshots, GUI automation, shell execution, file operations, system administration, and network tools. The server provides secure remote access with authentication, HTTPS support, and OAuth 2.0 integration for various MCP clients.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• Snapshot

  Capture desktop screenshots with optional JPEG compression

  Try:Take a screenshot of my desktopTry:Capture the active window
• Click

  Simulate mouse clicks at specific screen coordinates

  Try:Click on the OK buttonTry:Left click at position (500, 300)
• Type

  Send keyboard input to the active window

  Try:Type 'Hello World'Try:Enter the password 'secret123'
• Shell

  Execute PowerShell or CMD commands

  Try:List all files in C:\UsersTry:Run 'ipconfig' and show results
• FileWrite

  Write content to files on the system

  Try:Create a new text file with 'Hello'Try:Save configuration settings
• FileRead

  Read contents of files on the system

  Try:Read the contents of document.txtTry:Show the log file content
• FileList

  List files and directories

  Try:Show all files in DownloadsTry:List directories in C:\Program Files
• ProcessList

  List running processes

  Try:Show all running processesTry:Find Chrome processes
• ProcessKill

  Terminate running processes

  Try:Kill the notepad processTry:Force close unresponsive application
• WindowList

  List all open windows

  Try:Show all open windowsTry:List browser windows only
• WindowFocus

  Bring a specific window to focus

  Try:Focus on Chrome windowTry:Bring Notepad to front
• OCR

  Extract text from screen regions using OCR

  Try:Read the text from this areaTry:Extract text from screenshot

Comparable tools

Installation

pip install winremote-mcp

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

{
  "mcpServers": {
    "winremote": {
      "type": "http",
      "url": "http://192.168.1.100:8090/mcp/",
      "oauth": {
        "clientId": "my-client",
        "clientSecret": "my-secret"
      }
    }
  }
}

FAQ

Is authentication required for remote access?

Yes, remote HTTP access requires authentication by default (API key or OAuth). The server refuses non-loopback binds without authentication.

Can I use this server for internet access?

Yes, but it's recommended to enable HTTPS with valid certificates for secure internet access. Self-signed certificates can be used for LAN access.

Compare winremote-mcp with