Best for
- Developers and QA engineer needing UI automation on Windows
- Individuals looking to integrate AI agents with desktop applications
- System administrators requiring file and registry operations
W
Windows MCP
Community
Windows-MCP enables seamless integration between AI agents and the Windows operating system.
GitHub source repository ↗
47FMRS · D
Windows-MCP is a powerful tool to connect AI agents with Windows, offering a comprehensive set of UI automation tools. Its lightweight design and broad compatibility make it easy to integrate. However, due to system-level privileges, careful security configuration is essential, especially for remote access. Overall, it's a reliable choice for users needing Windows automation.
Windows-MCP is a lightweight, open-source MCP server that bridges the gap between AI agents and Windows OS, enabling agents to perform tasks such as file navigation, application control, UI interaction, QA testing, and more. It supports Windows 7 through 11. It provides a rich toolset for UI automation, including simulation of keyboard and mouse, capturing window/UI state, and accessing PowerShell, file system, registry, etc. The server is released under the MIT license.
Tools
Click
Click on the screen at the given coordinates.
Type
Type text on an element, optionally clears existing text.
Scroll
Scroll vertically or horizontally on the window or specific regions.
Move
Move mouse pointer or drag (with drag=True) to coordinates.
Shortcut
Press keyboard shortcuts like Ctrl+C, Alt+Tab.
Wait
Pause for a defined duration.
WaitFor
Wait until text, an active window, an element, or a focused element appears by polling UI state.
DisplayInventory
Read display layout, work areas, effective DPI, and scale metadata.
Screenshot
Fast screenshot-first desktop capture with cursor position, active windows, and an image.
Snapshot
Full desktop state capture for interactive element IDs, scrollable regions, or DOM-based browser extraction.
App
Launch an application by Start Menu name or executable path; resize, move, and switch between windows.
PowerShell
Execute PowerShell commands.
FileSystem
Read, write, copy, move, delete, list, search, and inspect files and directories.
Scrape
Scrape the entire webpage for information.
MultiSelect
Select multiple items (files, folders, checkboxes) with optional Ctrl key.
MultiEdit
Enter text into multiple input fields at specified coordinates.
Clipboard
Read or set Windows clipboard content.
Process
List running processes or terminate them by PID or name.
Notification
Send a Windows toast notification with a title and message.
Registry
Read, write, delete, or list Windows Registry values and keys.
Setup
- Ensure Python 3.13+ and UV are installed (
pip install uv). 2. For Claude Desktop, add the following toclaude_desktop_config.json: {"mcpServers":{"windows-mcp":{"command":"uvx","args":["windows-mcp","serve"]}}}. 3. Fully restart Claude Desktop. 4. For other clients, refer to the README for specific steps.
claude_desktop_config.json
{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp",
"serve"
]
}
}
}
Fit and risk
Not for
- Non-Windows platforms (e.g., macOS, Linux)
- Scenarios requiring precise text selection or IDE programming support
- Older Windows versions not covered by supported OS list
Required permissions
- Access to UI elements via UI automation APIs
- Execute PowerShell commands
- Filesystem read/write and delete
- Registry read/write
- Access to clipboard
- Start and manage processes
Risks and side effects
- Has full system access and can perform irreversible operations (e.g., delete files, modify registry)
- Remote access risk if exposed over network
- UI automation may be unstable, especially under heavy load or complex UI
- It may interfere with running applications or cause unexpected behavior
Troubleshooting
- Ensure Python 3.13+ is used
- Ensure 'English' is set as default language, else disable 'App-Tool'
- First run may take 1-2 minutes to install dependencies
- If encountering 'Connection closed' errors, use full path to uvx.exe
- Check log files: `~/.windows-mcp/server.log` and `server.error.log`
Use cases
Automate UI interactions in desktop applications
File management and navigation
Execute PowerShell commands and scripts
Web scraping and browser automation
QA testing and desktop validation
Supported clients
Claude DesktopFull support
Claude CodeFull support
Perplexity DesktopFull support
Gemini CLIFull support
Qwen CodeFull support
Codex CLIFull support
Autohand CodeFull support