An MCP Server for computer-use in Windows OS. It provides MCP “tools” targeted at desktop automation on Windows, covering environments from Windows 7 through Windows 11. The project is identified as “Windows-MCP” and is licensed under MIT.
🛠️ Key Features
MCP server focused on Windows computer-use
Desktop-oriented tooling
Topics include tools, windows-automation, and platform Windows 7–11
🚀 Use Cases
Automating interactions with Windows desktop environments
Building or integrating Windows-focused MCP toolchains for developer workflows
⚡ Developer Benefits
Clearly scoped to Windows 7–11 platform support
Python 3.13+ runtime indicated in the project excerpt
⚠️ Limitations
Scope appears limited to Windows OS desktop usage (not described for other operating systems)
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.
The current package requires Python 3.14+, which supports Windows 10 and newer. Earlier Windows versions are not supported by the current installation.
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 0.2 to 0.5 secs, and may slightly vary based on the number of active applications and system load, also the inferencing speed of the llm.
DOM Mode for Browser Automation
Special use_dom=True mode for State-Tool that focuses exclusively on web page content, filtering out browser UI elements for cleaner, more efficient web automation. Supports Chrome, Edge, and Firefox (Firefox uses an IAccessible2 fallback since it doesn't expose RootWebArea via UIA).
🛠️Installation
Note: When you install this MCP server for the first time it may take a minute or two because of installing the dependencies in pyproject.toml. In the first run the server may timeout ignore it and restart it.
Prerequisites
Python 3.14+
UV (Package Manager) from Astra, install with pip install uv or curl -LsSf https://astral.sh/uv/install.sh | sh
The App tool resolves localized Start Menu display names as well as internal app names; an English Windows display language is not required.
Install it as a background task that starts now and at every login:
shell
windows-mcp install
# Or choose the HTTP transport and bind address explicitly
windows-mcp install --transport sse --host 127.0.0.1 --port 8000
This creates a per-user Scheduled Task named windows-mcp-server and a wrapper script at
~/.windows-mcp/start-server.cmd. Use windows-mcp uninstall to remove it. Logs are written
to ~/.windows-mcp/server.log and ~/.windows-mcp/server.error.log.
git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP
Add this to your claude_desktop_config.json:
json
{"mcpServers":{"windows-mcp":{"command":"uv","args":["--directory","<path to the windows-mcp directory>","run","windows-mcp","serve"]}}}
Fully restart Claude Desktop and verify the server appears in the MCP tools list.
Claude Desktop MSIX (Windows Store)
The MSIX-packaged Claude Desktop (Microsoft Store version) virtualizes %APPDATA%. This causes two main issues:
The config file is located at: %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json (not %APPDATA%\Claude\).
Automatic installation from the "Claude Directory" will fail because the ${__dirname} variable resolves to the incorrect (non-virtualized) path.
To configure Windows-MCP on the Windows Store version of Claude:
You must manually edit the configuration file. Note that Electron apps in the MSIX sandbox do not inherit the system PATH, so you must use the full absolute path to uvx.exe (or uv.exe).
Replace <user> with your Windows username. To find the correct paths, run where uvx, where windows-mcp, or where uv. Fully quit Claude Desktop (Tray → Quit) and reopen after saving the config.
For additional Claude Desktop integration troubleshooting, see the MCP documentation.
Open Perplexity Desktop and go to Settings -> Connectors -> Add Connector -> Advanced.
Enter the name as Windows-MCP, then paste one of the following configs.
Option A: Install from PyPI (Recommended)
json
{"command":"uvx","args":["windows-mcp","serve"]}
Option B: Install from Source
json
{"command":"uv","args":["--directory","<path to the windows-mcp directory>","run","windows-mcp","serve"]}
Click Save, then restart Perplexity Desktop if needed.
For additional Claude Desktop integration troubleshooting, see the Perplexity MCP Support. The documentation includes helpful tips for checking logs and resolving common issues.
Use uvx to run the latest version directly from PyPI.
shell
claude mcp add --transport stdio windows-mcp -- uvx windows-mcp serve
Option B: Install from Source
Clone the repository:
shell
git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP
Run the following command in your terminal:
shell
claude mcp add --transport stdio windows-mcp -- uv --directory "<path>" run windows-mcp serve
Note: To make the server available across all projects, add --scope user to the command.
Rerun Claude Code in terminal. Enjoy 🥳
Note: On Windows, if you encounter "Connection closed" errors, use the full path to uvx.exe:
shell
claude mcp add --transport stdio windows-mcp -- C:\Users\<user>\.local\bin\uvx.exe windows-mcp serve
To verify the server is registered, run claude mcp list. Inside Claude Code, use /mcp to check server status.
WSL (Windows Subsystem for Linux)
If you run Claude Code from WSL, the MCP server must still execute on the Windows side (it needs Windows APIs for UI automation). Use powershell.exe as the command to bridge WSL and Windows:
Install uv on Windows (from a PowerShell terminal):
powershell
irm https://astral.sh/uv/install.ps1 | iex
From your WSL terminal, register the server:
shell
claude mcp add windows-mcp --transport stdio -s user -- powershell.exe -Command "C:\Users\<user>\.local\bin\uvx.exe windows-mcp serve"
Replace <user> with your Windows username. The -s user flag makes the server available across all projects.
Restart Claude Code and verify with /mcp.
🖥️ Running Windows-MCP
Windows-MCP runs directly on your Windows machine and exposes its tools to the connected MCP client.
shell
# Runs with stdio transport (default)
uvx windows-mcp serve
# Or with SSE/Streamable HTTP for network access
uvx windows-mcp serve --transport sse --host localhost --port 8000
uvx windows-mcp serve --transport streamable-http --host localhost --port 8000
Optional environment variables can be set to customize behavior — see Environment Variables below.
Security for Remote Access
For network access, enable authentication and TLS:
Restricts connections to specified CIDR ranges. Blocks private/loopback IPs by default.
CORS Origins
By default, no CORS headers are emitted. Browsers block cross-origin requests via their own Same-Origin Policy, which means arbitrary websites cannot reach the MCP control plane even if the server is on localhost. Host-header validation (DNS rebinding protection) is also applied automatically based on the bind address.
If you need a browser-based MCP client to reach the server, opt in with an explicit origin allowlist:
Only the listed origins receive Access-Control-Allow-Origin headers; all other cross-origin requests are rejected by the browser. The equivalent environment variable is WINDOWS_MCP_CORS_ORIGINS.
Tool Selection
All tools are enabled by default. Use --tools to whitelist specific tools, or --exclude-tools to block specific ones.
shell
windows-mcp serve --tools "Screenshot,Click,Snapshot" # Enable only these tools
windows-mcp serve --exclude-tools "PowerShell,Registry" # Disable specific tools
Tool names are not case-sensitive. A name that matches no tool stops the server with an error that lists the tool names.
GET /.well-known/oauth-authorization-server — server metadata (RFC 8414)
GET /oauth/authorize — Authorization Code + PKCE (S256 required)
POST /oauth/token — token exchange (client secret required)
POST /oauth/register — disabled; clients must be pre-provisioned
Dynamic client registration is disabled. Redirect URIs must be loopback http(s) only.
Auth key and OAuth can coexist — both are accepted as valid Bearer tokens.
Config File (~/.windows-mcp/config.toml)
Instead of passing flags every time, store your configuration in ~/.windows-mcp/config.toml. CLI flags always override config file values.
Search order:
--config /path/to/config.toml
~/.windows-mcp/config.toml
stdio — local only, no security needed:
toml
[server]transport = "stdio"
SSE — network access with auth and IP restriction:
Desktop control is enabled by default with the relaxed policy: direct desktop
actions are gated, while background tools can run as you use the computer.
Configure it in ~/.windows-mcp/config.toml (or disable it entirely with enabled = false):
In your MCP client's launch arguments, put these options after serve.
The priority is CLI > environment variable > TOML > default. --control can
explicitly override enabled = false. The timeout accepts finite positive seconds
(including fractions); zero does not disable control. The default remains 10 seconds.
Restart the Windows-MCP server process after changing these settings. There is no
hot reload or AI configuration tool. ControlStatus reports the effective enabledpolicy, and idle_timeout_seconds values, with state disabled when control is off.
Disabling control turns off ownership gating, physical input protection, takeover
monitoring, and the control indicator. Tools remain available and serialized, with
injected key/button cleanup retained. AI desktop actions can then interfere with your
own input; PowerShell scripts can also operate the UI. The separate screenshot flash
setting is unchanged. When control is enabled, the idle timer restarts with physical
input, so shortening it does not allow gated calls while you keep using the computer.
Before AI starts a new control period, the screen edges turn amber and a dialog
counts down from consent_countdown_seconds. Allow now starts control at once,
and input in the first second after it (your hand leaving the mouse) does not take the
desktop back; the takeover hotkey still does. Deny (or closing the dialog) rejects the call with CONTROL_DENIED, and an
unanswered countdown starts control, so unattended runs keep working. If you use the
mouse or keyboard during the countdown without answering, you stay in control and the
call returns USER_CONTROL. Consent lasts until you take the desktop back; later AI
calls do not ask again, even after the agent releases control. The prompt also appears while you
are using the computer, instead of a silent USER_CONTROL. After you deny, ignore it
while working, or take the desktop back from AI, calls return USER_CONTROL without
asking until you have been idle for idle_timeout_seconds. Set
consent_countdown_seconds = 0 (0–60) to start control without asking.
During AI control, small mouse movements remain blocked without pausing the current
tool. Mouse takeover adds up the length of each relative raw-input movement,
including back-and-forth movement, until it reaches 500 device units by default.
A gap of 0.5 seconds without movement starts a new segment; switching devices or
starting a new control period also clears the total. Set control.mouse_takeover_units
in TOML to change the threshold (40–2000), then restart the server. These are device
units, not screen pixels. Devices that do not provide identifiable relative raw
input, including some touchpads and remote-input devices, must use
Ctrl+Alt+Shift+Backspace to take over. The legacy mouse_takeover_pixels setting
is still accepted for compatibility but no longer affects takeover.
Desktop gate policies
Policy
Operations that require desktop ownership
relaxed (A, default)
Direct input: Click, Type, Scroll, Move, Shortcut, MultiSelect, MultiEdit; App switch and resize.
balanced (B)
Everything in A, plus PowerShell, Notification, App launch/launch_executable, Process kill, and Clipboard set.
strict (C)
All tools except ControlStatus, matching the previous gate behavior.
FileSystem, Registry, Snapshot, Screenshot, Scrape, Wait, WaitFor, DisplayInventory,
Process list, and Clipboard get bypass ownership in A and B. This classification
concerns desktop interference, not permissions or data safety. PowerShell can still
operate the UI, and file/registry operations can have other side effects.
Ungated calls do not acquire the desktop lease, activate its indicator,
or wait for its tool lock. Existing resource constraints still apply: UI Automation
operations share a dedicated worker, so a long WaitFor can delay other UIA work.
The separate screenshot flash is unchanged. --no-control retains its existing
all-tools serialization and overrides the policy's ownership checks.
In relaxed mode, agents should prefer background work and coordinate known desktop
interference with the user. Obtain permission before knowingly disrupting a user's
process or taking focus, reusing existing authorization. These are tool-use guidelines,
not server-enforced approval or process ownership tracking. Clipboard continues to
use the real Windows clipboard; no virtual clipboard is introduced.
For contributors: tool categories and the few mode-specific exceptions live in
src/windows_mcp/tools/control_policy.py. Update that table when adding tools or modes;
registration coverage tests detect omissions. Unknown extensions conservatively
use the gate. Keep policy decisions out of individual tool implementations.
Cursor positioning failures
If Windows rejects SetCursorPos, input tools return an error instead of reporting
success or continuing with a click or text entry at the wrong location. Check that
the server can access the active input desktop and whether the target application
is running with higher privileges. The error includes the Windows error code when
available; some failures provide no extended error code. These checks are diagnostic
suggestions, not a determination of the cause. Windows-MCP does not elevate itself.
auth Helper
Generate an auth key and save a working config to ~/.windows-mcp/config.toml:
This command writes the auth key into the config file, can generate cert.pem and key.pem, and prints an example MCP client configuration for the selected transport.
All variables are optional unless noted. Set them via the env key in claude_desktop_config.json (or your MCP client's equivalent config).
Screenshot & Snapshot
Variable
Default
Description
WINDOWS_MCP_SCREENSHOT_SCALE
1.0
Scale factor applied to screenshots before encoding. Accepts a float in the range 0.1–1.0. Useful on high-resolution displays (1440p, 4K) where the default produces images that exceed Claude Desktop's 1 MB tool-result limit. Set to 0.5 to halve both dimensions (quarter the file size).
WINDOWS_MCP_SCREENSHOT_BACKEND
auto
Screenshot capture backend. Accepted values: auto (tries dxcam → mss → pillow in order), dxcam, mss, pillow. Use mss or pillow if dxcam is unavailable or causes issues on your GPU.
WINDOWS_MCP_PROFILE_SNAPSHOT
(disabled)
Set to 1, true, yes, or on to emit per-stage timing logs for Screenshot/Snapshot calls. Useful for diagnosing slow captures.
WINDOWS_MCP_DISABLE_FLASH
(disabled)
Set to 1, true, yes, or on to suppress the orange-red glowing border that briefly highlights the captured area after every screenshot. The flash is rendered on a transparent always-on-top window after capture so it never appears in the captured image.
WINDOWS_MCP_MERGE_WORD_NODES
(disabled)
Set to 1, true, yes, or on to merge adjacent Word leaves on the same text line into one node. Electron/Chromium apps can report one word per glyph (each CJK character becomes its own node), which can dominate Snapshot output; merging keeps one clickable node per text run. Leave it off when you need to click individual words.
Excluding processes from UI Automation traversal
Variable
Default
Description
WINDOWS_MCP_EXCLUDE_PROCESSES
(none)
Comma-separated process basenames whose windows are excluded from UI Automation window metadata and tree traversal, e.g. Code.exe,Cursor.exe. Matching is case-insensitive and exact — no wildcards or regular expressions. Unset or empty preserves current behaviour.
Some applications expose accessibility trees that can become slow or unresponsive during UI Automation traversal. Snapshot and WaitFor may traverse the active window and other top-level handles selected for tree capture, so one pathological accessibility provider can stall the capture.
Set:
text
WINDOWS_MCP_EXCLUDE_PROCESSES=Code.exe,Cursor.exe
Process names are comma-separated executable basenames. They are matched case-insensitively after surrounding whitespace is stripped; empty entries are ignored and duplicates are harmless.
A window is excluded before any UI Automation call is made against it, so its accessibility provider is never entered during Snapshot collection. Excluded windows are omitted from the window list and active-window metadata as well as the accessibility tree, and they are not reported as failed captures. If the foreground window belongs to an excluded process, no active window is reported. If the owning process of a window cannot be resolved, the window is queried and traversed as usual.
This is an exclusion mechanism — a mitigation, not a complete fix for every form of #383. It only skips the processes you name; a pathological window you have not listed can still stall a capture.
UI Automation timeouts
Variable
Default
Description
WINDOWS_MCP_UIA_CONNECTION_TIMEOUT_MS
2000
Milliseconds UI Automation waits to connect to a window's accessibility provider before failing that window. Positive integer; anything else uses the default.
WINDOWS_MCP_UIA_TRANSACTION_TIMEOUT_MS
5000
Milliseconds a single UI Automation call into a provider may take before it fails. Positive integer; anything else uses the default.
When a window stops answering UI Automation (its UI thread is busy, deadlocked, or still starting up), Snapshot, WaitFor and other UI-tree tools now skip that window after one timeout. The window is reported as a failed capture, and the rest of the desktop is still returned. Previously the call waited until the window recovered, and every later tool call queued behind it. Raise these values only if an application legitimately needs longer for a single accessibility call. To stop traversing an application at all, use WINDOWS_MCP_EXCLUDE_PROCESSES.
Desktop control settings
If a physical key/button release event is missed, the input monitor checks residual
holds after the configured idle wait. Five consecutive all-released samples, at
least 100 ms apart, clear the stale records. New physical input or a reported held
key/button resets confirmation. This is best-effort: a zero GetAsyncKeyState
result counts as released even when Windows cannot provide the state; repeated
sampling filters transient readings but cannot distinguish persistent query failure.
Variable
Default
Description
WINDOWS_MCP_CONTROL
true
Enable desktop control coordination. Set to false to disable. Equivalent to --control/--no-control; restart required.
WINDOWS_MCP_CONTROL_POLICY
relaxed
Gate policy: relaxed, balanced, or strict. Equivalent to --control-policy; restart required.
WINDOWS_MCP_CONTROL_IDLE_TIMEOUT
10.0
Finite positive idle wait in seconds. Equivalent to --control-idle-timeout; restart required.
Security
Variable
Default
Description
WINDOWS_MCP_AUTH_KEY
(none)
Bearer token required on all HTTP requests. Alternative to --auth-key CLI flag.
WINDOWS_MCP_IP_ALLOWLIST
(none)
Comma-separated list of allowed client IPs or CIDR ranges (e.g., 203.0.113.0/24,198.51.100.5). Alternative to --ip-allowlist CLI flag.
WINDOWS_MCP_CORS_ORIGINS
(none)
Comma-separated list of origins permitted to make cross-origin browser requests (e.g., https://my-client.example.com). No CORS headers are emitted when unset. Alternative to --cors-origins CLI flag.
WINDOWS_MCP_TOOLS
(all enabled)
Comma-separated explicit list of tools to enable (e.g., Screenshot,Click,Snapshot). Alternative to --tools CLI flag.
WINDOWS_MCP_EXCLUDE_TOOLS
(none)
Comma-separated list of tools to disable (e.g., PowerShell,Registry). Alternative to --exclude-tools CLI flag.
WINDOWS_MCP_SSL_CERTFILE
(none)
Path to TLS certificate file (.pem) for HTTPS. Must be provided with WINDOWS_MCP_SSL_KEYFILE.
WINDOWS_MCP_SSL_KEYFILE
(none)
Path to TLS private key file (.pem) for HTTPS. Must be provided with WINDOWS_MCP_SSL_CERTFILE.
WINDOWS_MCP_OAUTH_CLIENT_ID
(none)
OAuth client ID for HTTP transports. Must be provided with WINDOWS_MCP_OAUTH_CLIENT_SECRET.
WINDOWS_MCP_OAUTH_CLIENT_SECRET
(none)
OAuth client secret for HTTP transports. Must be provided with WINDOWS_MCP_OAUTH_CLIENT_ID.
WINDOWS_MCP_STATELESS_HTTP
false
Set to 1, true, yes, or on to run streamable-http without Mcp-Session-Id connection state. Useful for reconnects after restarts and for horizontally scaled deployments.
Telemetry
Variable
Default
Description
ANONYMIZED_TELEMETRY
true
Set to false to disable anonymous usage telemetry. No personal data, tool arguments, or outputs are ever collected regardless of this setting.
POSTHOG_API_KEY
Project default
Override the PostHog project write key used for anonymous telemetry. Set to an empty string to skip PostHog client initialization.
POSTHOG_HOST
https://us.i.posthog.com
Override the PostHog host for anonymous telemetry, such as for a self-hosted PostHog deployment.
Debug
Variable
Default
Description
WINDOWS_MCP_DEBUG
false
Set to 1, true, yes, or on to enable debug mode, which sets the log level to DEBUG for verbose output. Also available as the --debug CLI flag.
WatchDog
Variable
Default
Description
WINDOWS_MCP_WATCHDOG
false
Set to on, 1, true, yes, or enabled (case-insensitive) to run the UIA focus watchdog. It is off by default because its only remaining effect is debug logging of focus changes, while it costs a background thread and a long-lived UIA event subscription that can crash the server on unstable UIA environments after long uptime (e.g. across a sleep/resume or session change). The accessibility tree is built on demand for every tool call either way, so tool behaviour is unaffected.
MCP Client can access the following tools to interact with Windows:
Click: Click on the screen at the given coordinates.
Type: Type text on an element (optionally clears existing text).
Scroll: Scroll vertically or horizontally on the window or specific regions.
Move: Move mouse pointer or drag (set drag=True) to coordinates. For deterministic
drag, set from_loc=[x, y] with drag=True to press at an explicit start point and
release at loc in one tool call. Optional duration adds bounded intermediate
movement. Drag is not supported on XAML shell surfaces such as Start menu tiles and
pinned taskbar buttons: they ignore synthesized mouse input, so the drag silently does
nothing while the call still succeeds. Use their context-menu commands (Move to front,
Move left, Move right on Start menu tiles) instead.
WaitFor: Wait until text, an active window, an element, or a focused element appears by polling UI state inside one tool call.
ControlStatus: Read the desktop control owner and remaining user-idle wait; release=true ends AI control. It stays available when user takeover blocks new tool calls. AI control has no time limit: once a gated call takes the desktop, it stays with AI between calls until the agent releases it, the user takes over, or the server stops. During AI control, a visible edge and a cursor glow tagged AI indicate ownership, and each AI click shows a brief expanding ring at the click point; moving the physical mouse substantially or pressing Ctrl+Alt+Shift+Backspace returns control to the user until 10 seconds of inactivity. During screenshot capture, the indicator is temporarily hidden and physical input is released; any physical input during this interval preempts AI control, although ControlStatus can briefly still report ai until that event is processed. Stepwise desktop input stops at its next checkpoint, but an already-running external command (for example PowerShell or an App launch) may continue after takeover; this control gate does not cancel processes or undo completed side effects. On a detected hook fault, injected keys and mouse buttons are released asynchronously, so physical input can briefly overlap a still-held AI key or button. Windows may also silently remove a low-level hook without notifying this process; periodic hook replacement reduces but does not eliminate that undetected window. User takeover is therefore best-effort, not a security boundary or a guarantee of exclusive control.
Sessionless MCP 2026-07-28 clients cannot receive unsolicited control-state logs; they should query ControlStatus when they need the current owner.
DisplayInventory: Read display layout, work areas, effective DPI, and scale metadata.
Screenshot: Fast screenshot-first desktop capture with cursor position, active/open windows, and an image. Skips UI tree extraction for speed and should be the default first call when you mainly need visual context. Supports display=[0] or display=[0,1] using zero-based active Windows display indices, and region=[left, top, right, bottom] (virtual-desktop pixel coordinates) to capture just that rectangle instead of the whole screen — cheaper on tokens when you already know which area matters. region takes precedence over display when both are given; an invalid or out-of-bounds region raises an error. After capture, a brief orange-red glowing border is drawn inside the captured area as a visual confirmation (set WINDOWS_MCP_DISABLE_FLASH=1 to disable).
Snapshot: Full desktop state capture for workflows that need interactive element ids, scrollable regions, or use_dom=True browser extraction. Supports use_vision=True for including screenshots, display=[0] or display=[0,1] using zero-based active Windows display indices, and region=[left, top, right, bottom] (virtual-desktop pixel coordinates) to inspect just that rectangle instead of the whole screen; region takes precedence over display when both are given, and an invalid or out-of-bounds region raises an error.
App: Launch an application by Start Menu name or strictly by executable path with separated argv and optional cwd; resize, move, and switch between windows.
PowerShell: To execute PowerShell commands.
FileSystem: Read, write, copy, move, delete, list, search, and inspect files and directories.
Scrape: To scrape the entire webpage for information.
MultiSelect: Select multiple items (files, folders, checkboxes) with optional Ctrl key. Uses bulk label-to-coordinate resolution when labels are provided.
MultiEdit: Enter text into multiple input fields at specified coordinates. Uses bulk label-to-coordinate resolution when labels are provided.
Clipboard: Read or set Windows clipboard content.
Process: List running processes or terminate them by PID or name.
Notification: Send a Windows toast notification with title, message, and a required app_id (registered Windows AppUserModelID). See the example below.
Registry: Read, write, delete, or list Windows Registry values and keys.
Toast notifications
Notification requires a registered Windows AppUserModelID in app_id, in addition
to title and message. Windows attributes the toast to that app. To find IDs
registered on the target machine, run this in PowerShell (or via the PowerShell tool):
powershell
Get-StartApps | Select-Object Name, AppID
Use the AppID value, not the app's display name. For example, if the list includes
Microsoft.Windows.Explorer, an MCP tool call is:
Thanks to all the amazing people who have contributed to Windows-MCP! 🎉
We appreciate every contribution, whether it's code, documentation, bug reports, or feature suggestions. Want to contribute? Check out our Contributing Guidelines!
🔒 Security
Important: Windows-MCP operates with full system access and can perform irreversible operations. Please review our comprehensive security guidelines before deployment.
For detailed information on what data is collected and how it is handled, please refer to the Telemetry and Data Privacy section in our Security Policy.
📝 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.)
This MCP server can't be used to play video games 🎮.
🪪 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgements
Windows-MCP makes use of several excellent open-source projects that power its Windows automation features: