Windows Desktop

v1.0.0File Systemsstable

A .NET-based Windows desktop automation MCP (Model Context Protocol) server that provides AI assistants with the ability to interact with the Windows desktop environment.

mcpocrtoolwindows
Share:
220
Stars
0
Downloads
0
Weekly
0/5

What is Windows Desktop?

Windows Desktop is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to .net-based windows desktop automation mcp (model context protocol) server that provides ai assistants with the ability to interact with the windows desktop environment.

A .NET-based Windows desktop automation MCP (Model Context Protocol) server that provides AI assistants with the ability to interact with the Windows desktop environment.

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

Features

  • A .NET-based Windows desktop automation MCP (Model Context P

Use Cases

Automate Windows desktop operations and interactions.
Perform OCR and visual screen analysis.
Control Windows applications programmatically.
shuyu-labs

Maintainer

LicenseMIT
Languagec#
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx windows-mcp-net

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

Windows MCP.Net is a .NET-based MCP server that gives AI assistants comprehensive control over the Windows desktop environment through more than 40 tools spanning desktop operations, file system management, OCR text recognition, UI element detection, and system controls like brightness and volume. It enables fully automated workflows such as extracting data from a web page, entering it into a desktop application, capturing results, and saving them to disk — all through natural language instructions to an AI client. It is built on .NET 10.0 and is designed exclusively for Windows.

Prerequisites

  • .NET 10.0 Runtime or higher installed on Windows
  • Windows 10 or later operating system
  • dotnet CLI available in your PATH
  • An MCP-compatible client such as Claude Desktop
1

Install .NET 10.0 Runtime

Download and install the .NET 10.0 Runtime from Microsoft's official .NET download page if it is not already installed.

dotnet --version
2

Install WindowsMCP.Net as a global tool

Install the server globally using the dotnet tool install command.

dotnet tool install --global WindowsMCP.Net
3

Configure your MCP client

Add the server to your claude_desktop_config.json using the dnx command format.

{
  "mcpServers": {
    "WindowsMCP.Net": {
      "type": "stdio",
      "command": "dnx",
      "args": ["WindowsMCP.Net@", "--yes"]
    }
  }
}
4

Restart your MCP client

Restart Claude Desktop to load the new server configuration.

5

Test with a basic automation task

Ask Claude to take a screenshot or read text from the screen to confirm the server is operational.

Windows Desktop Examples

Client configuration

Claude Desktop configuration for the Windows MCP.Net server using the dotnet global tool installation.

{
  "mcpServers": {
    "WindowsMCP.Net": {
      "type": "stdio",
      "command": "dnx",
      "args": ["WindowsMCP.Net@", "--yes"]
    }
  }
}

Prompts to try

Example prompts for Windows desktop automation via Claude.

- "Take a screenshot of the current screen and describe what you see."
- "Read all text visible on the screen using OCR."
- "Open Notepad, type 'Hello World', and save the file as test.txt on the Desktop."
- "Find the button labeled 'Submit' in the current window and click it."
- "Set the system volume to 50%."

Troubleshooting Windows Desktop

'dnx' is not recognized as a command

Ensure the .NET global tools directory is on your system PATH. Run `dotnet tool install --global WindowsMCP.Net` in a new terminal window and confirm the install succeeded. Add `%USERPROFILE%\.dotnet\tools` to your PATH environment variable if needed.

OCR tools return empty results

OCR requires Windows.Media.Ocr, which is available on Windows 10 and later. Ensure the language pack for the text you want to recognize is installed in Windows Settings > Time & Language > Language.

UI automation fails to find specific application windows

Some applications use custom UI frameworks that are not fully accessible via the Windows Automation API. Try locating elements by their coordinates using screenshot-based tools, or run Claude Desktop as Administrator if the target app requires elevated privileges.

Frequently Asked Questions about Windows Desktop

What is Windows Desktop?

Windows Desktop is a Model Context Protocol (MCP) server that .net-based windows desktop automation mcp (model context protocol) server that provides ai assistants with the ability to interact with the windows desktop environment. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Windows Desktop?

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

Which AI clients work with Windows Desktop?

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

Is Windows Desktop free to use?

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

Browse More File Systems MCP Servers

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

Quick Config Preview

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

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

Read the full setup guide →

Ready to use Windows Desktop?

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