Windows-MCP — Claude Code MCP server for Windows control
An MCP server that hands your AI agent the Windows desktop: launch apps, click, type, and read window state.
claude mcp add windows-mcp -- uvx windows-mcpWhat Windows-MCP does
Windows-MCP connects an LLM to the Windows operating system. The agent opens programs, presses buttons, types text, and captures the state of a window or a web page. It works with any model — no separate vision model required.
The package ships tools for keyboard, mouse, and UI capture. State-Tool has a use_dom=True mode that keeps only page content and drops browser chrome; it supports Chrome, Edge, and Firefox. Latency between actions usually runs 0.2–0.5 seconds and depends on system load and model speed.
You need Python 3.14+ and the UV package manager. The server targets Windows 10 and 11; the current installation will not work on older Windows releases. The first run can take a minute or two while dependencies install, and the server may time out — restart it if that happens.
What it helps with
- open an app and walk through its steps
- check a program's UI after a build
- fill in a web form through the agent
- capture window state and hand it to the model
- run a browser QA scenario without manual clicks
Example prompts for the agent
- Open Calculator and multiply 128 by 47
- Find the schedule page in Chrome and list the first three rows
- Take a screenshot of the active window and describe what looks wrong
How to install Windows-MCP
Platform CLI
claude mcp add windows-mcp -- uvx windows-mcpuvx runs the command named after the package; if the README names another one, use uvx --from windows-mcp <command>
Platform CLI
codex mcp add windows-mcp -- uvx windows-mcpuvx runs the command named after the package; if the README names another one, use uvx --from windows-mcp <command>
Config file
{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from windows-mcp <command>
Config file
{
"servers": {
"windows-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"windows-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from windows-mcp <command>
Platform CLI
gemini mcp add windows-mcp uvx windows-mcpuvx runs the command named after the package; if the README names another one, use uvx --from windows-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Windows-MCP
How do I install Windows-MCP in Claude Code?
Run claude mcp add windows-mcp -- uvx windows-mcp. Install Python 3.14+ and UV first.
What does Windows-MCP do?
It gives the agent tools for Windows: launching apps, managing windows, simulating mouse and keyboard input, and reading UI state.
Which systems are supported?
Windows 10 and Windows 11. The current package needs Python 3.14+, so it will not install on older Windows releases.
