Skip to main content
Glama

Windows MCP

by CursorTouch

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.

🎥 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 1.5 to 2.3 secs, and may slightly vary based on the number of active applications and system load, also the inferencing speed of the llm.

Supported Operating Systems

  • Windows 7
  • Windows 8, 8.1
  • Windows 10
  • Windows 11

Installation

Prerequisites

  • Python 3.13+
  • Anthropic Claude Desktop app or other MCP Clients
  • UV (Package Manager) from Astra, install with pip install uv
  • DXT (Desktop Extension) from Antropic, install with npm install -g @anthropic-ai/dxt

🏁 Getting Started

  1. Clone the repository.
git clone https://github.com/CursorTouch/Windows-MCP.git cd Windows-MCP
  1. Build Desktop Extension DXT:
npx @anthropic-ai/dxt pack
  1. Open Claude Desktop:

Go to Claude Desktop: Settings->Extensions->Install Extension (locate the .dxt file)-> Install

Finally Enjoy 🥳.

For additional Claude Desktop integration troubleshooting, see the MCP documentation. The documentation includes helpful tips for checking logs and resolving common issues.


🛠️MCP Tools

Claude 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).
  • Clipboard-Tool: Copy or paste using the system clipboard.
  • 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).
  • Key-Tool: Press a single key.
  • Wait-Tool: Pause for a defined duration.
  • State-Tool: Combined snapshot of active apps and interactive, textual and scrollable elements along with screenshot of the desktop.
  • Screenshot-Tool: Capture a screenshot of the desktop.
  • Launch-Tool: To launch an application from the start menu.
  • Shell-Tool: To execute PowerShell commands.
  • Scrape-Tool: To scrape the entire webpage for information.

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.

📝 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.)

🪪License

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

🤝Contributing

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

Made with ❤️ by Jeomon George

Citation

@software{ author = {George, Jeomon}, title = {Windows-MCP: Lightweight open-source project for integrating LLM agents with Windows}, year = {2024}, publisher = {GitHub}, url={https://github.com/CursorTouch/Windows-MCP} }
-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A lightweight open-source server that enables AI agents to interact with the Windows operating system, allowing for file navigation, application control, UI interaction, and QA testing without requiring computer vision.

  1. ✨ Key Features
    1. Supported Operating Systems
  2. Installation
    1. Prerequisites
  3. 🏁 Getting Started
    1. 🛠️MCP Tools
      1. Star History
        1. ⚠️Caution
          1. 📝 Limitations
            1. 🪪License
              1. 🤝Contributing
                1. Citation

                  Related MCP Servers

                  • -
                    security
                    A
                    license
                    -
                    quality
                    A server that enables AI assistants to understand and interact with Unity projects in real-time, providing access to scene hierarchy, project settings, and the ability to execute code directly in the Unity Editor.
                    Last updated -
                    40
                    MIT License
                    • Linux
                    • Apple
                  • -
                    security
                    A
                    license
                    -
                    quality
                    An MCP server that bridges AI agents with GUI automation capabilities, allowing them to control mouse, keyboard, windows, and take screenshots to interact with desktop applications.
                    Last updated -
                    Python
                    MIT License
                    • Apple
                    • Linux
                  • -
                    security
                    A
                    license
                    -
                    quality
                    An open-source self-hosted browser agent that provides a dockerized browser environment for AI automation, allowing other AI apps and agents to perform human-like web browsing tasks through natural language instructions.
                    Last updated -
                    66
                    61
                    TypeScript
                    Apache 2.0
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A lightweight server that enables AI agents to interact with the Windows operating system, allowing for file navigation, application control, UI interaction, and QA testing through various tools.
                    Last updated -
                    172
                    Python
                    MIT License

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/CursorTouch/windows-mcp-server'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server