Windows MCP

v1.0.0Browser Automationstable

Enables AI agents to interact with Windows operating systems by providing tools for UI automation, file navigation, application control, and system operations. Works with any LLM to perform tasks like clicking, typing, launching applications, and exe

aidesktopmcptoolswindows
Share:
5,661
Stars
0
Downloads
0
Weekly
0/5

What is Windows MCP?

Windows MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai agents to interact with windows operating systems by providing tools for ui automation, file navigation, application control, and system operations. works with any llm to perform tasks like...

Enables AI agents to interact with Windows operating systems by providing tools for UI automation, file navigation, application control, and system operations. Works with any LLM to perform tasks like clicking, typing, launching applications, and exe

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

Features

  • Enables AI agents to interact with Windows operating systems

Use Cases

Automate Windows UI interactions
Control applications and system operations
Simulate clicks, typing, and window management
CursorTouch

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

PIP

pip install windows_mcp

Manual Installation

pip install windows_mcp

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 Windows MCP

Windows MCP is a Python-based MCP server that gives AI agents full control over Windows operating systems through UI automation, file system access, PowerShell execution, and registry operations. It supports 2M+ users through Claude Desktop Extensions and exposes over a dozen tools covering clicks, typing, screenshots, window management, application launching, and web scraping — all accessible to any LLM without specialized vision models. Teams use it to automate repetitive desktop tasks, build unattended RPA workflows, and let AI assistants interact with legacy applications that have no API.

Prerequisites

  • Windows 7, 8, 10, or 11 (English as default system language for App tool)
  • Python 3.13+ installed
  • UV package manager installed (pip install uv)
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Install the UV package manager

Windows MCP is distributed as a Python package and is best run via uvx for zero-config execution. Install UV first if you don't have it.

pip install uv
2

Test the server with uvx

Run a quick test to confirm Windows MCP installs and starts correctly. The serve subcommand launches the stdio MCP server.

uvx windows-mcp serve
3

Configure Claude Desktop to use Windows MCP

Edit your Claude Desktop config file at %APPDATA%\Claude\claude_desktop_config.json and add the windows-mcp server entry.

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": ["windows-mcp", "serve"],
      "env": {
        "WINDOWS_MCP_SCREENSHOT_SCALE": "0.5",
        "ANONYMIZED_TELEMETRY": "false"
      }
    }
  }
}
4

Optionally install as a background Windows service

For persistent availability without running the MCP client, install windows-mcp as a system service that starts automatically.

windows-mcp install
5

Verify tools are available in your AI client

Restart Claude Desktop and ask it to take a screenshot of your desktop. If the Screenshot tool responds with an image, the server is connected correctly.

Windows MCP Examples

Client configuration

Claude Desktop configuration for Windows MCP with screenshot scaling for high-DPI displays and telemetry disabled.

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": ["windows-mcp", "serve"],
      "env": {
        "WINDOWS_MCP_SCREENSHOT_SCALE": "0.5",
        "ANONYMIZED_TELEMETRY": "false"
      }
    }
  }
}

Prompts to try

Control Windows applications, automate file operations, and execute system tasks through natural language.

- "Take a screenshot of my desktop and tell me what applications are open"
- "Open Notepad, type 'Hello World', and save the file to C:\\temp\\test.txt"
- "Find all PDF files in my Downloads folder and list them"
- "Run a PowerShell command to check how much disk space is available on C:\\"
- "Close all browser windows and then open Chrome to google.com"

Troubleshooting Windows MCP

App tool fails to launch applications by name

The App tool requires English as the Windows system language for application name resolution. If your system uses a different language, launch apps by their full executable path instead (e.g., C:\Program Files\...\app.exe).

Screenshots are too large and slow down responses

Set the WINDOWS_MCP_SCREENSHOT_SCALE environment variable to 0.5 in your config to halve the image dimensions. This is especially important for 4K and high-DPI displays.

uvx command not found when Claude Desktop tries to start the server

UV must be installed and available in the PATH used by Claude Desktop. Run 'pip install uv' and verify with 'uvx --version'. On some systems you may need to add the UV binary directory to your system PATH environment variable.

Frequently Asked Questions about Windows MCP

What is Windows MCP?

Windows MCP is a Model Context Protocol (MCP) server that enables ai agents to interact with windows operating systems by providing tools for ui automation, file navigation, application control, and system operations. works with any llm to perform tasks like clicking, typing, launching applications, and exe It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Windows MCP?

Install via pip with: pip install windows_mcp. Then configure your AI client to connect to this MCP server.

Which AI clients work with Windows MCP?

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

Is Windows MCP free to use?

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

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.

Quick Config Preview

{ "mcpServers": { "windows-mcp": { "command": "pip", "args": ["install", "windows_mcp"] } } }

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

Read the full setup guide →

Ready to use Windows MCP?

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