Windows MCP

{ "manifest_version": "0.2", "name": "Windows-MCP", "version": "0.5.6", "description": "MCP Server that enables Claude to interact with Windows OS", "long_description": "Windows MCP is an open-source project that enables seamless integration between AI agents and the Windows operating system. Acting as an MCP server, it bridges the gap between large language models (LLMs) and the Windows OS, allowing agents to perform tasks such as **file navigation, application control, UI interaction, QA testing, and more**.\n\n**KEY FEATURES**\n- **Seamless Windows Integration**: Interacts natively with Windows UI elements, opens applications, controls windows, simulates user input, and more.\n- **Use Any LLM (Vision Optional)**: Does not rely on traditional computer vision techniques or fine-tuned models. Works with any LLM, reducing complexity and setup time.\n- **Rich Toolset for UI Automation**: Includes tools for keyboard and mouse control, window management, and capturing window or UI state.\n- **Lightweight & Open-Source**: Minimal dependencies with full source code available under the MIT license.\n- **Customizable & Extendable**: Easily adapt or extend tools to suit custom automation workflows or AI integrations.\n- **Real-Time Interaction**: Typical latency between actions ranges from `1.5` to `2.3` seconds, depending on system load, active applications, and LLM inference speed.\n\n**MINIMUM REQUIREMENTS**\n- Python 3.13 or higher\n- UV Package Manager\nThis MCP server requires UV, a fast Python package manager.\nInstallation:\n`curl -LsSf https://astral.sh/uv/install.sh | sh`\nFor detailed installation instructions, [see the UV documentation](https://github.com/astral-sh/uv)", "author": { "name": "CursorTouch", "url": "https://cursortouch.com/" }, "homepage": "https://cursortouch.com/", "documentation": "https://github.com/CursorTouch/Windows-MCP", "support": "https://github.com/CursorTouch/Windows-MCP", "icon": "./assets/logo.png", "screenshots": [ "./assets/screenshots/screenshot_1.png", "./assets/screenshots/screenshot_2.png", "./assets/screenshots/screenshot_3.png" ], "server": { "type": "python", "entry_point": "./src/windows_mcp/__main__.py", "mcp_config": { "command": "uv", "args": [ "--directory", "${__dirname}", "run", "windows-mcp" ], "env": { "ANONYMIZED_TELEMETRY": "${user_config.anonymized_telemetry}" } } }, "user_config": { "anonymized_telemetry": { "type": "boolean", "title": "Anonymized Telemetry", "description": "Windows-MCP collects basic usage data to help improve the MCP server. No personal information, tool arguments, or tool outputs are tracked.", "required": false, "default": true } }, "tools": [ { "name": "App Tool", "description": "Manages Windows applications through launch, resize, and window switching operations." }, { "name": "Powershell Tool", "description": "Execute PowerShell commands and return the output with status code" }, { "name": "State Tool", "description": "Capture comprehensive desktop state including focused/opened applications, interactive UI elements (buttons, text fields, menus), informative content (text, labels, status), and scrollable areas. Optionally includes visual screenshot when use_vision=True. Essential for understanding current desktop context and available UI interactions." }, { "name": "Click Tool", "description": "Click on UI elements at specific coordinates. Supports left/right/middle mouse buttons and single/double/triple clicks. Use coordinates from State Tool output." }, { "name": "Type Tool", "description": "Type text into input fields, text areas, or focused elements. Set clear=True to replace existing text, False to append. Click on target element coordinates first." }, { "name": "Scroll Tool", "description": "Scroll at specific coordinates or current mouse position. Use wheel_times to control scroll amount (1 wheel = ~3-5 lines). Essential for navigating lists, web pages, and long content." }, { "name": "Drag Tool", "description": "Drag and drop operation from source coordinates to destination coordinates. Useful for moving files, resizing windows, or drag-and-drop interactions." }, { "name": "Move Tool", "description": "Move mouse cursor to specific coordinates without clicking. Useful for hovering over elements or positioning cursor before other actions." }, { "name": "Shortcut Tool", "description": "Execute keyboard shortcuts using key combinations. Pass keys as list (e.g., 'ctrl'+'c' for copy, 'alt'+'tab' for app switching, 'win'+'r' for Run dialog, 'win' is for opening the start menu)." }, { "name": "Wait Tool", "description": "Pause execution for specified duration in seconds. Useful for waiting for applications to load, animations to complete, or adding delays between actions." }, { "name": "Scrape Tool", "description": "Fetch content from a URL or the active browser tab. By default (use_dom=False), performs a lightweight HTTP request to the URL and returns markdown content of complete webpage. Note: Some websites may block automated HTTP requests. If this fails, open the page in a browser and retry with use_dom=True to extract visible text from the active tab's DOM within the viewport." } ], "compatibility": { "platforms": [ "win32" ], "runtimes": { "python": ">=3.13" } }, "keywords": [ "windows", "automation", "ai", "mcp", "computer-use" ], "license": "MIT", "repository": { "type": "git", "url": "https://github.com/CursorTouch/Windows-MCP" } }