MCP server

Windows-MCP

Computer use on Windows: open apps, click, type and read the screen through UI automation. Community-maintained (CursorTouch on GitHub), not by the company whose product it connects to. It runs locally on your machine over stdio. Setup below for 12 clients (checked 2026-10-25). Repo and registry data checked 2026-10-24.

Maintainer: Community
Runs: Local (stdio)
Repo: CursorTouch/Windows-MCP
GitHub: ★ 10,235, last push 2026-10-24 (checked 2026-10-24)
License: MIT
Registry: io.github.CursorTouch/Windows-MCP

Install Windows-MCP

Pick your client. Each tab starts the same local command. Config shapes checked against each client's docs on 2026-10-25.

Run in a terminal. Everything after -- is the command that starts the server. docs

claude mcp add --transport stdio windows-mcp -- uvx windows-mcp

Claude Desktop only: Settings > Developer > Edit Config opens claude_desktop_config.json. Add this, save and restart the app. docs

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

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs

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

Add to Cursor

Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs

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

Add to VS Code

Run codex mcp add windows-mcp -- uvx windows-mcp, or add this to ~/.codex/config.toml. docs

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

Run in a terminal (-s user adds it for all projects; the default is this project). docs

gemini mcp add -s user windows-mcp uvx windows-mcp

Run in a terminal; it writes ~/.copilot/mcp-config.json. docs

copilot mcp add windows-mcp -- uvx windows-mcp

Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs

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

Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs

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

Add to opencode.json in the project (or ~/.config/opencode/opencode.json). docs

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "windows-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "windows-mcp"
      ],
      "enabled": true
    }
  }
}

Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs

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

MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs

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

Security notes

The local server runs with your user's permissions (uvx downloads it from PyPI on first run).
It reads files you point it at. Give it only the folders it needs.
Community code: read it (or at least the tools it registers) before you give it credentials.

Alternatives

all file system & documents MCP servers →

Boxofficial
Hosted server for searching, reading and asking questions about files in Box.
Dropboxofficial
Search and read files in Dropbox (hosted server).
Filesystemreference
Read, write, move and search files inside the folders you allow.
Google Docsofficial
Google's hosted server for reading and writing Google Docs documents (developer preview).
Google Driveofficial
Google's hosted MCP server for finding and reading Google Drive files (developer preview).
Google Sheetsofficial
Google's hosted server for reading and editing Google Sheets spreadsheets (developer preview).
Google Slidesofficial
Google's hosted server for reading and building Google Slides decks (developer preview).
MarkItDownofficial
Convert PDF, Word, Excel, PowerPoint, images and audio to Markdown.

FAQ

What does the Windows-MCP do?+

Computer use on Windows: open apps, click, type and read the screen through UI automation.

Is the Windows-MCP MCP server official?+

Community-maintained (CursorTouch on GitHub), not by the company whose product it connects to.

How do I add Windows-MCP to Claude Code?+

Run: claude mcp add windows-mcp -- uvx windows-mcp. Add --scope project to share it with your team through .mcp.json.

How do I use the Windows-MCP MCP server in Cursor or VS Code?+

Open the Cursor or VS Code tab above: it has the mcp.json entry and a one-click install link. Cursor uses the "mcpServers" key; VS Code uses "servers" and needs a type ("stdio").

Does Windows-MCP work in ChatGPT and claude.ai?+

No: it runs locally over stdio, and ChatGPT and claude.ai only connect to remote servers. Use it in Claude Desktop, Claude Code, Cursor, VS Code or another client that can start a local process.

What are the alternatives to the Windows-MCP MCP server?+

Other file system & documents MCP servers: Box, Dropbox, Filesystem, Google Docs and Google Drive.

All MCP servers · What is an MCP server? · Agent skills