Installation

Get Windows-MCP running in minutes.

Prerequisites

  • • Windows 7, 8, 10, 11, or Windows Server 2022
  • • Python 3.13+
  • • UV package manager — pip install uv
  • • An MCP client (Claude Desktop, Cursor, VS Code, etc.)

Local mode — free

Control your own Windows machine. No account needed.

Option A — PyPI (recommended)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": ["windows-mcp"]
    }
  }
}

Option B — From source

git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP

Then add to your config:

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\Windows-MCP", "run", "windows-mcp"]
    }
  }
}

Remote mode — pro

Connect to an isolated cloud sandbox. No local resources used.

  1. 1. Create an account and sign in
  2. 2. Purchase credits from Dashboard → Billing
  3. 3. Create a sandbox from Dashboard → Sandboxes
  4. 4. Generate an API key from Dashboard → API Keys
  5. 5. Configure your MCP client:
{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": ["windows-mcp"],
      "env": {
        "SCOPE": "remote",
        "API_KEY": "sk-wmcp-xxxxxxxxxx",
        "SANDBOX_ID": "sandbox-xxxxxxxx"
      }
    }
  }
}

Make sure the sandbox is running before connecting.

Configuration

SCOPElocal (default) or remote
API_KEYRequired for remote mode
SANDBOX_IDOptional — auto-selects first running sandbox if omitted

Troubleshooting

Server not appearing?

Check your config JSON is valid. Restart your MCP client. Make sure uvx is in your PATH.

Remote connection failing?

Confirm the sandbox is “Running” in the dashboard. Check your API key is correct.

Python errors?

Requires Python 3.13+. Check with python --version.

IntroductionCloud Sandboxes