
Windows-MCP Server: Setup for Claude Desktop, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install Windows MCP
Claude Code
- 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
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 ·
ScreenshotReads 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 ·
SnapshotClicks at a spot on the screen
Clicks at the coordinates the assistant picks from the screen state.
Try: “Click the Submit button.”
Write ·
ClickTypes 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 ·
TypeScrolls 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 ·
ScrollMoves 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 ·
MovePresses keyboard shortcuts
Sends key combinations such as Ctrl+C or Alt+Tab.
Try: “Press Ctrl+S to save.”
Write ·
ShortcutOpens, 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 ·
AppRuns 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 ·
PowerShellReads, 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 ·
FileSystemReads or sets what is on your clipboard
Reads the current clipboard content or replaces it.
Try: “Copy this text to my clipboard.”
Write ·
ClipboardLists running programs or stops them
Lists running processes or ends one by its ID or name.
Try: “Close Chrome, it is frozen.”
Delete ·
ProcessReads, changes and deletes Windows registry entries
Reads, writes, deletes or lists keys and values in the Windows Registry.
Try: “Show me the registry value that controls the default browser.”
Delete ·
RegistryReads the text of a whole web page
Pulls the information from an entire web page.
Try: “Scrape this article and summarise it.”
Network ·
ScrapeSelects several files, folders or boxes at once
Selects multiple items, optionally holding Ctrl, resolving labels to positions in bulk.
Try: “Tick all three checkboxes in this form.”
Write ·
MultiSelectFills in several text fields in one go
Enters text into multiple input fields in one call.
Try: “Fill in the name, address and phone fields.”
Write ·
MultiEditPauses for a set time
Waits for a number of seconds before continuing.
Try: “Wait five seconds for the page to load.”
Read ·
WaitWaits until something appears on screen
Polls the screen until some text, a window or an element appears.
Try: “Wait until the Install finished window shows up.”
Read ·
WaitForShows who is controlling the desktop
Reports whether the AI or you currently has control, and how long until control returns to you after you move the mouse.
Try: “Who has control of the desktop right now?”
Read ·
ControlStatusLists your monitors and their sizes
Reads the layout, work areas, scaling and DPI of each display.
Try: “How many monitors do I have and what size are they?”
Read ·
DisplayInventoryShows a Windows pop-up notification
Sends a toast notification with a title and message, attributed to a registered Windows app ID.
Try: “Notify me when the download finishes.”
Write ·
Notification
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
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
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-only | Start 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 to | Anonymous usage telemetry unless you turn it off. Network mode (optional) listens on the host and port you choose |
| Sign-in and keys | No 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
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- github.com · github.com
- pypi.org · pypi.org