Windows-MCP

At a glance

Windows-MCP reads the Windows accessibility tree to find buttons, fields and menus, then clicks, types, scrolls and switches windows like a person at the keyboard. It also reaches past the screen: PowerShell, the file system, the clipboard, running processes and the registry.

That reach is the reason to set it up with care. It runs as your user with no sandbox, so turn off the tools you do not need (PowerShell and Registry are the obvious ones) and keep it on a machine where a wrong click is cheap.

Made by

CursorTouch

Licence

MIT

Latest version

0.8.8 (10 Oct 2026)

PyPI package

windows-mcp

GitHub stars

10.4K

Downloads

23.1K a week

Last commit

26 Oct 2026

Tools

21

Runs on

Your computer

Our check: It needs something our Linux test machine does not have (an account, a desktop app, a Mac or a running service), so on 27 Oct 2026 we read its tools from the source code instead of running this config. windows-mcp on PyPI links back to CursorTouch/Windows-MCP. Version 0.8 needs the serve subcommand, which the shared database config left out.

What's in the pod: its tools

We found 21 tools in its source code on 27 Oct 2026. 7 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.

How we tested it: Read from the source of Windows-MCP 0.8.8. It installs only on Windows (it depends on pywin32), so our Linux machine could not start it.

Grouped and described by us. The README on GitHub lists the inputs each tool takes.

Set it up

Pick your app for the exact snippet and where it goes.

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp",
        "serve"
      ]
    }
  }
}

claude mcp add-json windows-mcp '{"command":"uvx","args":["windows-mcp","serve"]}'

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp",
        "serve"
      ]
    }
  }
}

{
  "servers": {
    "windows-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "windows-mcp",
        "serve"
      ]
    }
  }
}

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp",
        "serve"
      ]
    }
  }
}

Add "--exclude-tools", "PowerShell,Registry" after serve to start without its two most powerful tools. Set "ANONYMIZED_TELEMETRY": "false" in env to switch off its usage reporting.

New to this? See the setup guides for Claude Code, Cursor, Claude Desktop and ChatGPT.

Settings

Names are exactly as the project spells them. Required ones are marked.

What it can touch

Safer setup: Start it with --exclude-tools PowerShell,Registry, use --control-policy strict so it waits until you stop using the computer, and try it in a Windows virtual machine before your main PC.

Before you start

• Windows 10 or 11
• Python 3.14 or newer and uv (for uvx)

If it does not work

The first start times out

uvx is still downloading dependencies the first time. Wait a minute and restart the client; later starts are quick.

Claude Desktop from the Microsoft Store does not see the server

The Store version keeps its config under %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude, and it does not inherit PATH, so use the full path to uvx.exe as the command.

Screenshots fail or are rejected as too large

Set WINDOWS_MCP_SCREENSHOT_SCALE to 0.5, or switch WINDOWS_MCP_SCREENSHOT_BACKEND to mss or pillow if the default capture method fails on your graphics card.

Snapshot hangs on one app

Some apps answer accessibility queries very slowly. Name them in WINDOWS_MCP_EXCLUDE_PROCESSES.

Running Claude Code inside WSL

The server has to run on the Windows side. Register it with powershell.exe -Command and the Windows path to uvx.exe, as the project README shows.

Peas in a pod: similar servers

How Windows-MCP lines up against other agent helpers and desktop control servers on the shelf.

Questions

Something wrong on this page? Tell us.