Windows-MCP

[](https://mseep.ai/app/cursortouch-windows-mcp) <div align="center"> <h1>🪟 Windows-MCP</h1> <a href="https://github.com/CursorTouch/Windows-MCP/blob/main/LICENSE"> <img src="https://img.shields.io/badge/license-MIT-green" alt="License"> </a> <img src="https://img.shields.io/badge/python-3.13%2B-blue" alt="Python"> <img src="https://img.shields.io/badge/platform-Windows%207–11-blue" alt="Platform: Windows 7 to 11"> <img src="https://img.shields.io/github/last-commit/CursorTouch/Windows-MCP" alt="Last Commit"> <br> <a href="https://x.com/CursorTouch"> <img src="https://img.shields.io/badge/follow-%40CursorTouch-1DA1F2?logo=twitter&style=flat" alt="Follow on Twitter"> </a> <a href="https://discord.com/invite/Aue9Yj2VzS"> <img src="https://img.shields.io/badge/Join%20on-Discord-5865F2?logo=discord&logoColor=white&style=flat" alt="Join us on Discord"> </a> </div> <br> **Windows MCP** is a lightweight, open-source project that enables seamless integration between AI agents and the Windows operating system. Acting as an MCP server bridges the gap between LLMs and the Windows operating system, allowing agents to perform tasks such as **file navigation, application control, UI interaction, QA testing,** and more. mcp-name: io.github.CursorTouch/Windows-MCP ## Updates - Windows-MCP is now available on [PyPI](https://pypi.org/project/windows-mcp/) (thus supports `uvx`) - Windows-MCP is added to [MCP Registry](https://github.com/modelcontextprotocol/registry) - Try out 🪟[Windows-Use](https://github.com/CursorTouch/Windows-Use)!!, an agent built using Windows-MCP. - Windows-MCP is now featured as Desktop Extension in `Claude Desktop`. ### Supported Operating Systems - Windows 7 - Windows 8, 8.1 - Windows 10 - Windows 11 ## 🎥 Demos <https://github.com/user-attachments/assets/d0e7ed1d-6189-4de6-838a-5ef8e1cad54e> <https://github.com/user-attachments/assets/d2b372dc-8d00-4d71-9677-4c64f5987485> ## ✨ Key Features - **Seamless Windows Integration** Interacts natively with Windows UI elements, opens apps, controls windows, simulates user input, and more. - **Use Any LLM (Vision Optional)** Unlike many automation tools, Windows MCP doesn't rely on any traditional computer vision techniques or specific fine-tuned models; it works with any LLMs, reducing complexity and setup time. - **Rich Toolset for UI Automation** Includes tools for basic keyboard, mouse operation and capturing window/UI state. - **Lightweight & Open-Source** Minimal dependencies and easy setup with full source code available under MIT license. - **Customizable & Extendable** Easily adapt or extend tools to suit your unique automation or AI integration needs. - **Real-Time Interaction** Typical latency between actions (e.g., from one mouse click to the next) ranges from **0.7 to 2.5 secs**, and may slightly vary based on the number of active applications and system load, also the inferencing speed of the llm. - **DOM Mode for Browser Automation** Special `use_dom=True` mode for State-Tool that focuses exclusively on web page content, filtering out browser UI elements for cleaner, more efficient web automation. ## 🛠️Installation ### Prerequisites - Python 3.13+ - UV (Package Manager) from Astra, install with `pip install uv` or `curl -LsSf https://astral.sh/uv/install.sh | sh` - `English` as the default language in Windows highly preferred or disable the `App-Tool` in the MCP Server for Windows with other languages. <details> <summary>Install in Claude Desktop</summary> 1. Install [Claude Desktop](https://claude.ai/download) and ```shell npm install -g @anthropic-ai/mcpb ``` 2. Configure the extension: **Option A: Install from PyPI (Recommended)** Use `uvx` to run the latest version directly from PyPI. Add this to your `claude_desktop_config.json`: ```json { "mcpServers": { "windows-mcp": { "command": "uvx", "args": [ "windows-mcp" ] } } } ``` **Option B: Install from Source** 1. Clone the repository: ```shell git clone https://github.com/CursorTouch/Windows-MCP.git cd Windows-MCP ``` 2. Add this to your `claude_desktop_config.json`: ```json { "mcpServers": { "windows-mcp": { "command": "uv", "args": [ "--directory", "<path to the windows-mcp directory>", "run", "windows-mcp" ] } } } ``` 3. Open Claude Desktop and enjoy! 🥳 5. Enjoy 🥳. For additional Claude Desktop integration troubleshooting, see the [MCP documentation](https://modelcontextprotocol.io/quickstart/server#claude-for-desktop-integration-issues). The documentation includes helpful tips for checking logs and resolving common issues. </details> <details> <summary>Install in Perplexity Desktop</summary> 1. Install