🪟 Windows-MCP

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 reached 1M+ Users in Claude Desktop Extensiosn.
• Windows-MCP is now available on PyPI (thus supports uvx windows-mcp)
• Windows-MCP is added to MCP Registry
• Try out 🪟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.

npm install -g @anthropic-ai/mcpb

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

git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path to the windows-mcp directory>",
        "run",
        "windows-mcp"
      ]
    }
  }
}

git clone https://github.com/CursorTouch/Windows-MCP.git

cd Windows-MCP

{
  "command": "uvx",
  "args": [
    "windows-mcp"
  ]
}

{
  "command": "uv",
  "args": [
    "--directory",
    "<path to the windows-mcp directory>",
    "run",
    "windows-mcp"
  ]
}

npm install -g @google/gemini-cli

{
  "theme": "Default",
  ...
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

npm install -g @qwen-code/qwen-code@latest

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

npm install -g @openai/codex

[mcp_servers.windows-mcp]
command="uvx"
args=[
  "windows-mcp"
]

🔨MCP Tools

MCP Client can access the following tools to interact with Windows:

• Click-Tool: Click on the screen at the given coordinates.
• Type-Tool: Type text on an element (optionally clears existing text).
• Scroll-Tool: Scroll vertically or horizontally on the window or specific regions.
• Drag-Tool: Drag from one point to another.
• Move-Tool: Move mouse pointer.
• Shortcut-Tool: Press keyboard shortcuts (Ctrl+c, Alt+Tab, etc).
• Wait-Tool: Pause for a defined duration.
• State-Tool: Combined snapshot of default language, browser, active apps and interactive, textual and scrollable elements along with screenshot of the desktop. Supports use_dom=True for browser content extraction (web page elements only) and use_vision=True for including screenshots.
• App-Tool: To launch an application from the start menu, resize or move the window and switch between apps.
• Shell-Tool: To execute PowerShell commands.
• Scrape-Tool: To scrape the entire webpage for information.

🤝 Connect with Us

Stay updated and join our community:

• 📢 Follow us on X for the latest news and updates

• 💬 Join our Discord Community

Star History

⚠️Caution

This MCP interacts directly with your Windows operating system to perform actions. Use with caution and avoid deploying it in environments where such risks cannot be tolerated.

🔒 Security

Important: Windows-MCP operates with full system access and can perform irreversible operations. Please review our comprehensive security guidelines before deployment.

For detailed security information, including:

• Tool-specific risk assessments
• Deployment recommendations
• Vulnerability reporting procedures
• Compliance and auditing guidelines

Please read our Security Policy.

📊 Telemetry

Windows-MCP collects usage data to help improve the MCP server. No personal information, no tool arguments, no outputs are tracked.

To disable telemetry, add the following to your MCP client configuration:

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ],
      "env": {
        "ANONYMIZED_TELEMETRY": "false"
      }
    }
  }
}

For detailed information on what data is collected and how it is handled, please refer to the Telemetry and Data Privacy section in our Security Policy.

📝 Limitations

• Selecting specific sections of the text in a paragraph, as the MCP is relying on a11y tree. (⌛ Working on it.)
• Type-Tool is meant for typing text, not programming in IDE because of it types program as a whole in a file. (⌛ Working on it.)
• This MCP server can't be used to play video games 🎮.

🪪 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements

Windows-MCP makes use of several excellent open-source projects that power its Windows automation features:

• UIAutomation

• PyAutoGUI

Huge thanks to the maintainers and contributors of these libraries for their outstanding work and open-source spirit.

🤝Contributing

Contributions are welcome! Please see CONTRIBUTING for setup instructions and development guidelines.

Made with ❤️ by CursorTouch

Citation

@software{
  author       = {CursorTouch},
  title        = {Windows-MCP: Lightweight open-source project for integrating LLM agents with Windows},
  year         = {2024},
  publisher    = {GitHub},
  url={https://github.com/CursorTouch/Windows-MCP}
}