Windows Desktop Automation

v1.0.0Developer Toolsstable

A Model Context Protocol server that wraps AutoIt functionality, enabling LLMs to automate Windows desktop tasks including mouse/keyboard operations, window management, and UI control interactions.

mcp-windows-desktop-automationmcpai-integration
Share:
110
Stars
0
Downloads
0
Weekly
0/5

What is Windows Desktop Automation?

Windows Desktop Automation is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that wraps autoit functionality, enabling llms to automate windows desktop tasks including mouse/keyboard operations, window management, and ui control interactions.

A Model Context Protocol server that wraps AutoIt functionality, enabling LLMs to automate Windows desktop tasks including mouse/keyboard operations, window management, and UI control interactions.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol server that wraps AutoIt functional

Use Cases

Automate Windows desktop tasks including mouse and keyboard operations.
Control window management and UI interactions through Claude.
Wrap AutoIt functionality for comprehensive Windows automation.
LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 14, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-windows-desktop-automation

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Windows Desktop Automation

The MCP Windows Desktop Automation server wraps AutoIt's comprehensive Windows GUI automation library and exposes it to AI assistants through the Model Context Protocol. It provides tools for mouse and keyboard operations, window management, UI control interactions, process management, file access, and screenshot capture — all callable from natural language. Developers and automation engineers use it to let AI assistants drive Windows desktop applications, fill forms, script repetitive tasks, and monitor UI state without writing AutoIt scripts by hand.

Prerequisites

  • Windows operating system (AutoIt is Windows-only)
  • Node.js 18 or higher with npm
  • AutoIt v3 installed (https://www.autoitscript.com/site/autoit/downloads/)
  • Git for cloning the repository
  • An MCP-compatible client such as Claude Desktop
1

Install AutoIt

Download and install AutoIt v3 from the official website. The MCP server wraps AutoIt's COM interface, so AutoIt must be installed before building the server.

2

Clone the repository

Clone the MCP Windows Desktop Automation repository from GitHub.

git clone https://github.com/mario-andreschak/mcp-windows-desktop-automation.git
cd mcp-windows-desktop-automation
3

Install dependencies and build

Install the Node.js packages and compile the TypeScript source.

npm install
npm run build
4

Start the server

Run the server in stdio mode (default) for use with Claude Desktop. Use --transport=websocket and --port if you prefer a WebSocket transport for remote clients.

npm start
# Or with WebSocket transport:
npm start -- --transport=websocket --port=3000
5

Add the server to Claude Desktop

Register the built server in claude_desktop_config.json so Claude Desktop launches it automatically.

{
  "mcpServers": {
    "windows-automation": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-windows-desktop-automation\\dist\\index.js"]
    }
  }
}

Windows Desktop Automation Examples

Client configuration

Claude Desktop config to launch the MCP Windows Desktop Automation server. Update the path to match your build output location.

{
  "mcpServers": {
    "windows-automation": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-windows-desktop-automation\\dist\\index.js"]
    }
  }
}

Prompts to try

These prompts exercise the mouse, keyboard, window, and screenshot capabilities of the server.

- "Take a screenshot of the current screen and describe what is open"
- "Find the window titled 'Notepad' and bring it to the front"
- "Type 'Hello World' into the currently active text field"
- "Click the OK button in the dialog box that is currently open"
- "Start the Calculator application and compute 1234 times 5678"
- "Fill in the login form on the open application with username 'admin' and submit it"

Troubleshooting Windows Desktop Automation

Server fails to start with 'AutoIt COM object not found' error

Ensure AutoIt v3 is installed from autoitscript.com and that the AutoIt COM server is registered. You can re-register it by running 'AutoIt3.exe /regserver' as Administrator from the AutoIt installation directory.

Window management tools cannot find the target window

AutoIt window matching is case-sensitive by default. Verify the exact window title by using the 'take a screenshot' prompt first to see what windows are visible, then use the exact title string in subsequent prompts.

Claude Desktop shows the server as disconnected immediately after startup

Check that Node.js 18+ is installed and on your PATH. Run 'node dist/index.js' manually from the project directory to see any startup errors. Ensure npm run build completed successfully before adding the server to the config.

Frequently Asked Questions about Windows Desktop Automation

What is Windows Desktop Automation?

Windows Desktop Automation is a Model Context Protocol (MCP) server that model context protocol server that wraps autoit functionality, enabling llms to automate windows desktop tasks including mouse/keyboard operations, window management, and ui control interactions. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Windows Desktop Automation?

Follow the installation instructions on the Windows Desktop Automation GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Windows Desktop Automation?

Windows Desktop Automation works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Windows Desktop Automation free to use?

Yes, Windows Desktop Automation is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-windows-desktop-automation": { "command": "npx", "args": ["-y", "mcp-windows-desktop-automation"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Windows Desktop Automation?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides