Log inSubmit server
Windows MCP logo

Windows MCP

Automates Windows 10 and 11 through MCP tools for UI interaction, app control, input simulation, and browser state.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Windows MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Windows-MCP connects AI agents to Windows 10 and 11 for file navigation, application control, UI interaction, and QA testing. It exposes tools for keyboard and mouse input, opening apps, controlling windows, and capturing UI state, with optional DOM-focused browser automation for Chrome, Edge, and Firefox. Run it locally with Python 3.14+ and uv, using stdio, SSE, or streamable HTTP transport. Reach for it when an agent needs to operate native Windows applications or interact with visible desktop interfaces.

Use cases

  • Automate native Windows applications
  • Navigate files through an AI agent
  • Simulate keyboard and mouse workflows
  • Inspect browser page content with DOM mode
  • Run Windows UI QA tests

Key features

  • Windows 10 and 11 desktop automation
  • Keyboard and mouse input
  • Application and window control
  • UI state capture
  • DOM mode for Chrome, Edge, and Firefox
  • Stdio, SSE, and streamable HTTP transports

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

54/54 checks healthy over the last 91d

Supply-chain signal

1 high-severity advisory on record for this package. Most advisories affect transitive dependencies and may not be exploitable in this server's actual usage — this is a directional signal, not a security audit.

Critical 0High 1Medium 0Low 1

Scanned 6d ago via OSV.dev · windows-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars11kStargazers on the source repository.
Last commitTodayMost recent push to the default branch.
Directory activity22 viewsConfig copies, upvotes, and views on AllMCPs.

How Windows MCP works

What Windows-MCP does

Windows-MCP gives MCP-compatible AI agents access to Windows desktop interaction. It is intended for automation tasks that require more than API calls, including navigating files, launching applications, controlling windows, simulating keyboard and mouse input, inspecting UI state, and performing QA workflows.

The server targets Windows 10 and Windows 11. Its interaction model works with any LLM and does not require traditional computer-vision methods or a dedicated fine-tuned model. Vision can be used by the connected model when appropriate, but it is not presented as a server requirement.

How it works

The server runs locally on the Windows machine and exposes its automation operations through the Model Context Protocol. It can run directly with uvx windows-mcp serve, or be configured as a background task that starts at login. Supported transports include the default local stdio mode, Server-Sent Events, and streamable HTTP.

Actions generally take between 0.2 and 0.5 seconds from one interaction to the next. Actual timing varies with system load, the number of open applications, and the connected model's inference speed.

Browser automation has a DOM mode enabled with use_dom=True on the State tool. This mode concentrates on webpage content instead of browser chrome and is available for Chrome, Edge, and Firefox. Firefox uses an IAccessible2 fallback because it does not expose RootWebArea through UI Automation.

Setup and configuration

Install Python 3.14 or newer and the uv package manager. The PyPI package can be launched with:

shell
uvx windows-mcp serve

For network transports, specify the transport, host, and port, such as --transport sse --host localhost --port 8000 or --transport streamable-http --host localhost --port 8000.

The windows-mcp install command creates a per-user Windows Scheduled Task named windows-mcp-server, starts it immediately, and runs it at future logins. The wrapper script is stored at ~/.windows-mcp/start-server.cmd; logs are written to ~/.windows-mcp/server.log and server.error.log. Run windows-mcp uninstall to remove the task.

Claude Desktop can use a stdio configuration that invokes uvx windows-mcp serve. The Microsoft Store edition requires extra care: its MSIX sandbox uses a different configuration path and may require an absolute path to uvx.exe, uv.exe, or the installed windows-mcp.exe.

Tools and capabilities

  • Open applications and resolve localized Start Menu display names.
  • Navigate files and interact with Windows UI elements.
  • Send basic keyboard and mouse input.
  • Control windows and capture current UI state.
  • Use DOM-focused state inspection for supported browsers.
  • Adapt or extend the available tools for custom automation needs.

Limitations and notes

The current package requires Python 3.14 or later and supports Windows 10 and newer. Earlier Windows versions are not supported. The first installation may take one or two minutes while dependencies are installed, and the initial server run may time out; restarting it is recommended. The server is licensed under MIT.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Windows MCP

Windows-MCP is an MCP server that connects AI agents to Windows 10 and 11, exposing tools for application control, window management, keyboard and mouse input, file navigation, UI-state capture, and browser DOM inspection. It runs locally with Python 3.14+ and supports stdio, SSE, and streamable HTTP transports.

Install Python 3.14+ and uv, then run `uvx windows-mcp serve`. You can also install it as a per-user Scheduled Task with `windows-mcp install`, which starts the server immediately and at each login.

Windows-MCP supports Windows 10 and Windows 11. The current package requires Python 3.14 or newer, and earlier Windows versions are not supported.

Add a `windows-mcp` MCP entry that runs `uvx` with `windows-mcp` and `serve` as arguments, then restart Claude Desktop. The Microsoft Store edition may require manually editing its virtualized configuration path and using an absolute executable path.

Yes, Windows-MCP provides DOM mode through the State tool for Chrome, Edge, and Firefox. Enable it with `use_dom=True` to focus state inspection on webpage content; Firefox uses an IAccessible2 fallback.

Related MCP servers

All in OS Automation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewWindows MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/windows-mcp?style=directory)](https://allmcps.com/mcp/windows-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/windows-mcp"><img src="https://allmcps.com/api/badge/windows-mcp?style=directory" alt="Windows MCP on AllMCPs" /></a>