PlugWiki
Windows-MCP logo

Windows-MCP Server: Setup for Claude Desktop, Cursor and Other Apps

CommunityLocal
GetPyPIwindows-mcpcursortouch/windows-mcp

Lets Claude and other assistants control a Windows PC: see the screen, click, type, open apps and run PowerShell.

Windows-MCP lets an assistant use your Windows computer the way you do, by looking at the screen and then clicking, typing and opening apps. It also has direct tools for files, the clipboard, running processes, the registry and PowerShell. It runs on your own PC, so the assistant gets the same access as your account. It works only on Windows 10 and 11 and needs Python 3.14 or newer.

Good for

  • People who want an assistant to do repetitive tasks in Windows apps
  • Developers testing desktop apps with an AI agent
  • Claude Desktop users on Windows who want an assistant to work in their own apps

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install Windows MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Windows MCP server to Claude Code. Run this command:
    
    claude mcp add --transport stdio windows-mcp -- uvx windows-mcp serve
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Windows 10 or 11, Python 3.14+, uv.

Read-only mode: Add the tools flag with a list of read tools (for example Screenshot,Snapshot) after serve, or the exclude-tools flag to drop PowerShell, FileSystem, Process and Registry.

Install uv first, and use Windows with Python 3.14 or newer. The command needs the serve subcommand, which plain uvx windows-mcp leaves out. If the app cannot find uvx, give the full path to uvx.exe; the README says this is needed for the Microsoft Store version of Claude Desktop. The first run installs dependencies and may time out, so restart it once.

From the project README. Source.

Tools

  • Takes a screenshot of the screen and lists open windows

    A fast capture of the desktop with the cursor position, the open windows and an image. You can limit it to one display or a rectangle. The README says to use it as the first call when you mainly need to see the screen.

    Try: “Take a screenshot and tell me what is open.”

    Read · Screenshot

  • Reads the screen with numbered clickable elements

    A fuller capture that lists interactive elements and scrollable areas so the assistant can click them by number. It can include a screenshot and can read a web page in a browser.

    Try: “Look at the screen and find the Save button.”

    Read · Snapshot

  • Clicks at a spot on the screen

    Clicks at the coordinates the assistant picks from the screen state.

    Try: “Click the Submit button.”

    Write · Click

  • Types text into a field

    Types text into an element, and can clear what was there first.

    Try: “Type my email address in the sign-in box.”

    Write · Type

  • Scrolls a window up, down or sideways

    Scrolls vertically or horizontally in a window or in a chosen region.

    Try: “Scroll down to the bottom of this page.”

    Write · Scroll

  • Moves the mouse or drags something

    Moves the pointer, or presses at one spot and releases at another to drag. The README says drag does nothing on Start menu tiles and pinned taskbar buttons, while the call still reports success.

    Try: “Drag this file into the Documents folder.”

    Write · Move

  • Presses keyboard shortcuts

    Sends key combinations such as Ctrl+C or Alt+Tab.

    Try: “Press Ctrl+S to save.”

    Write · Shortcut

  • Opens, resizes, moves and switches between apps

    Launches an app by its Start Menu name or by an executable path, and resizes, moves or switches windows.

    Try: “Open Notepad and put it on the left half of the screen.”

    Runs code · App

  • Runs PowerShell commands on your PC

    Executes any PowerShell command you or the assistant write, with the same rights as your Windows account. This is the most powerful tool in the set.

    Try: “List the five biggest files in my Downloads folder.”

    Delete · PowerShell

  • Reads, writes, copies, moves, deletes and searches files

    Handles files and folders on your PC: read, write, copy, move, delete, list, search and inspect.

    Try: “Find all PDFs in Documents modified this week.”

    Delete · FileSystem

  • Reads or sets what is on your clipboard

    Reads the current clipboard content or replaces it.

    Try: “Copy this text to my clipboard.”

    Write · Clipboard

  • Lists running programs or stops them

    Lists running processes or ends one by its ID or name.

    Try: “Close Chrome, it is frozen.”

    Delete · Process

Read from the source code

Permissions

high risk · 5 things to watch · 2 advisories

High risk

The assistant can see your screen, run PowerShell, change and delete files, end programs and edit the registry, with the rights of your Windows account. Switch on only the tools you need with the tool whitelist, and watch the first runs.

What it can do

Watch out for

  • It can run any PowerShell command

    The PowerShell tool runs commands with your account rights. Exclude it unless you need it. github.com

  • It can delete files and edit the registry

    The file tool deletes files, the registry tool deletes and writes keys, and the process tool ends programs. The README calls some operations irreversible. github.com

  • It controls your mouse and keyboard

    The assistant can click anything you can see. Moving your mouse or pressing Ctrl+Alt+Shift+Backspace hands control back to you. github.com

  • Network mode exposes your PC

    The optional SSE and HTTP modes listen on a network address. Use the auth key, IP allowlist and TLS the README describes, and keep the default stdio mode if you can. github.com

  • Anonymous telemetry is on by default

    The README says no personal data, tool arguments or outputs are collected. Set the telemetry variable to false to turn it off. github.com

Security advisories

Technical details
Turning on read-onlyStart the server with the tools flag listing only the read tools, for example Screenshot and Snapshot. Or use the exclude-tools flag to drop PowerShell, FileSystem, Process and Registry.
Talks toAnonymous usage telemetry unless you turn it off. Network mode (optional) listens on the host and port you choose
Sign-in and keysNo account or key for local use. Network mode can require a bearer token, IP allowlist, TLS or OAuth.

Questions

Does it work on Mac or Linux?

No. It runs only on Windows 10 and 11, because it uses Windows interfaces for the screen, files and registry.

What do I need installed first?

Python 3.14 or newer and the uv package manager. The README warns that the first run can take a minute or two and may time out, in which case you restart it.

Does it need an API key?

No. Local use with Claude Desktop or Claude Code needs no account or key. A bearer token is only for the optional network modes.

Can I make it read-only?

Mostly. Start it with a list of only the read tools, such as Screenshot and Snapshot, or exclude the PowerShell, file, process and registry tools. Without that, all tools are on.

Why does Claude Desktop say the server failed to start?

On the Microsoft Store (MSIX) version of Claude Desktop the app does not inherit your PATH, so the config needs the full path to uvx.exe. The README also says the first launch may time out while dependencies install.

Does it send my screen to anyone?

Screenshots go to the AI model you are chatting with, as with any screenshot you share. The server itself sends only anonymous telemetry, which you can turn off.

Is it official?

No. It is a community project by CursorTouch and is not made by Microsoft or Anthropic.

Information

updated Nov 2, 2026

Publisher
Community
Package
windows-mcp
Registry
PyPI
Transport
stdio
Auth
None
Version
1.0.1
License
MIT
Last commit
Oct 31, 2026
Open issues
25
Listed in
Official MCP registry

GitHubPyPIOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. github.com · github.com
  2. pypi.org · pypi.org

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.