🪟 Windows-MCP

@CursorTouch

About 🪟 Windows-MCP

MCP Server for Computer Use in Windows

#windows #tools #mcp #desktop #windows-10 #windows-11 #mcp-server

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Windows-MCP?

Windows-MCP is a lightweight, open-source MCP server that bridges AI agents (LLMs) with the Windows operating system. It enables agents to perform file navigation, application control, UI interaction, QA testing, and more.

How to use Windows-MCP?

Install Python 3.13+ and the uv package manager. Run uvx windows-mcp serve to start the server via stdio or use --transport sse for HTTP. For automatic startup at login, run windows-mcp install. Configuration instructions are provided for Claude Desktop, Perplexity Desktop, Gemini CLI, Qwen Code, Codex CLI, and Claude Code.

Key features of Windows-MCP

Seamless Windows integration with native UI interaction
Works with any LLM (vision not required)
Rich toolset for keyboard, mouse, and window automation
Lightweight and open-source under MIT license
Customizable and extendable toolset
Real-time interaction (0.2–0.5 second latency)
DOM Mode for browser automation (Chrome, Edge, Firefox)

Use cases of Windows-MCP

Automate file navigation and management
Control applications and windows programmatically
Perform UI interaction and QA testing
Enable AI agents to control Windows via natural language

FAQ from Windows-MCP

What operating systems does Windows-MCP support?

Windows 7, 8, 8.1, 10, and 11.

Does Windows-MCP require a specific LLM or computer vision?

No. It works with any LLM and does not rely on fine-tuned models or traditional computer vision techniques.

What are the runtime dependencies?

Python 3.13+ and the uv package manager. The server installs additional dependencies automatically via pyproject.toml.

How do I configure Windows-MCP for different MCP hosts?

The README provides step-by-step JSON configurations for Claude Desktop, Perplexity Desktop, Gemini CLI, Qwen Code, Codex CLI, and Claude Code, with source or PyPI installation options.

What should I do if the first run times out?

The first installation may take a minute or two for dependency setup. If the server times out, simply restart it.

Frequently asked questions