Windows MCP

1. Install Claude Desktop and

npm install -g @anthropic-ai/mcpb

2. Configure the extension:

Option A: Install from PyPI (Recommended)

Use uvx to run the latest version directly from PyPI.

Add this to your claude_desktop_config.json:

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

Option B: Install from Source

1. Clone the repository:

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

2. Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path to the windows-mcp directory>",
        "run",
        "windows-mcp"
      ]
    }
  }
}

3. Open Claude Desktop and enjoy! 🥳

4. Enjoy 🥳.

Claude Desktop MSIX (Windows Store)

The MSIX-packaged Claude Desktop virtualizes %APPDATA%. Config lives at: %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json (not %APPDATA%\Claude\). The "Edit Config" button may open the wrong file.

Electron apps also do not inherit PATH, so uv/uvx can fail with spawn ENOENT. Use the full absolute path to uv.exe:

{
  "mcpServers": {
    "windows-mcp": {
      "command": "C:\\Users\\<user>\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\<user>\\AppData\\Local\\Packages\\Claude_pzs8sxrjxfjjc\\LocalCache\\Roaming\\Claude\\Claude Extensions\\ant.dir.cursortouch.windows-mcp",
        "run",
        "windows-mcp"
      ]
    }
  }
}

Replace <user> with your username. To find uv.exe, run where uv in a terminal; common location is %USERPROFILE%\.local\bin\uv.exe. For PyPI install, use args: ["run", "windows-mcp"] instead of --directory/path. Save as UTF-8 without BOM (PowerShell Set-Content -Encoding UTF8 adds a BOM that breaks the JSON parser).

For additional Claude Desktop integration troubleshooting, see the MCP documentation.

1. Install Perplexity Desktop:

2. Clone the repository.

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

cd Windows-MCP

3. Open Perplexity Desktop:

Go to Settings->Connectors->Add Connector->Advanced

4. Enter the name as Windows-MCP, then paste the following JSON in the text area.

Option A: Install from PyPI (Recommended)

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

Option B: Install from Source

{
  "command": "uv",
  "args": [
    "--directory",
    "<path to the windows-mcp directory>",
    "run",
    "windows-mcp"
  ]
}

5. Click Save and Enjoy 🥳.

For additional Claude Desktop integration troubleshooting, see the Perplexity MCP Support. The documentation includes helpful tips for checking logs and resolving common issues.

1. Install Gemini CLI:

npm install -g @google/gemini-cli

2. Configure the server in %USERPROFILE%/.gemini/settings.json:

3. Navigate to %USERPROFILE%/.gemini in File Explorer and open settings.json.

4. Add the windows-mcp config in the settings.json and save it.

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

Note: To run from source, replace the command with uv and args with ["--directory", "<path>", "run", "windows-mcp"].

5. Rerun Gemini CLI in terminal. Enjoy 🥳

npm install -g @qwen-code/qwen-code@latest

2. Configure the server in %USERPROFILE%/.qwen/settings.json:

3. Navigate to %USERPROFILE%/.qwen/settings.json.

4. Add the windows-mcp config in the settings.json and save it.

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

Note: To run from source, replace the command with uv and args with ["--directory", "<path>", "run", "windows-mcp"].

5. Rerun Qwen Code in terminal. Enjoy 🥳

npm install -g @openai/codex

2. Configure the server in %USERPROFILE%/.codex/config.toml:

3. Navigate to %USERPROFILE%/.codex/config.toml.

4. Add the windows-mcp config in the config.toml and save it.

[mcp_servers.windows-mcp]
command="uvx"
args=[
  "windows-mcp"
]

Note: To run from source, replace the command with uv and args with ["--directory", "<path>", "run", "windows-mcp"].

5. Rerun Codex CLI in terminal. Enjoy 🥳