Install this MCP
Pick your client, then copy the config.
{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp",
"serve"
],
"env": {
"WINDOWS_MCP_SCREENSHOT_SCALE": "0.5"
}
}
}
}{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp",
"serve"
],
"env": {
"WINDOWS_MCP_SCREENSHOT_SCALE": "0.5"
}
}
}
}{
"servers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp",
"serve"
],
"env": {
"WINDOWS_MCP_SCREENSHOT_SCALE": "0.5"
}
}
}
}{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp",
"serve"
],
"env": {
"WINDOWS_MCP_SCREENSHOT_SCALE": "0.5"
}
}
}
}# Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.windows-mcp] command = "uvx" args = ["windows-mcp", "serve"] [mcp_servers.windows-mcp.env] WINDOWS_MCP_SCREENSHOT_SCALE = "0.5"
Set up with your agent
Uses the same client as above (Cursor). Paste into that agent.
Install the "Windows-MCP" MCP for Cursor in this workspace.
1. Read official install docs: https://github.com/CursorTouch/Windows-MCP
2. Merge this JSON into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp",
"serve"
],
"env": {
"WINDOWS_MCP_SCREENSHOT_SCALE": "0.5"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- WINDOWS_MCP_SCREENSHOT_SCALE (required): See repository README.
4. Restart Cursor if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/windows.htmlInstall the "Windows-MCP" MCP for Claude Desktop in this workspace.
1. Read official install docs: https://github.com/CursorTouch/Windows-MCP
2. Merge this JSON into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp",
"serve"
],
"env": {
"WINDOWS_MCP_SCREENSHOT_SCALE": "0.5"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- WINDOWS_MCP_SCREENSHOT_SCALE (required): See repository README.
4. Restart Claude Desktop if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/windows.htmlInstall the "Windows-MCP" MCP for VS Code in this workspace.
1. Read official install docs: https://github.com/CursorTouch/Windows-MCP
2. Merge this JSON into .vscode/mcp.json:
{
"servers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp",
"serve"
],
"env": {
"WINDOWS_MCP_SCREENSHOT_SCALE": "0.5"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- WINDOWS_MCP_SCREENSHOT_SCALE (required): See repository README.
4. Restart VS Code if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/windows.htmlInstall the "Windows-MCP" MCP for Windsurf in this workspace.
1. Read official install docs: https://github.com/CursorTouch/Windows-MCP
2. Merge this JSON into ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp",
"serve"
],
"env": {
"WINDOWS_MCP_SCREENSHOT_SCALE": "0.5"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- WINDOWS_MCP_SCREENSHOT_SCALE (required): See repository README.
4. Restart Windsurf if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/windows.htmlInstall the "Windows-MCP" MCP for Codex in this workspace. 1. Read official install docs: https://github.com/CursorTouch/Windows-MCP 2. Merge this TOML under [mcp_servers.*] into ~/.codex/config.toml (or .codex/config.toml in a trusted project): # Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.windows-mcp] command = "uvx" args = ["windows-mcp", "serve"] [mcp_servers.windows-mcp.env] WINDOWS_MCP_SCREENSHOT_SCALE = "0.5" 3. Required environment variables / secrets (ask the user; never invent secrets): - WINDOWS_MCP_SCREENSHOT_SCALE (required): See repository README. 4. Restart Codex if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets. Catalog: https://averlo.xyz/launches/windows.html
Try it
After install, paste one of these into your agent.
- Show me what Windows-MCP can do
- Set up a simple workflow using Windows-MCP
- List the tools available in Windows-MCP

