WinCtl MCP Server

by sitharaj88io.github.sitharaj88/winctlv1.0.2

WinCtl — full Windows desktop control for Claude and other MCP clients: screen capture, UI Automation, synthetic input, window and process management, files and shell, behind tiered permissions with audit logging.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install WinCtl MCP server

claude mcp add winctl -- npx -y @sitharaj88/winctl

{
  "mcpServers": {
    "winctl": {
      "command": "npx",
      "args": [
        "-y",
        "@sitharaj88/winctl"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "winctl": {
      "command": "npx",
      "args": [
        "-y",
        "@sitharaj88/winctl"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "winctl": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sitharaj88/winctl"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "winctl": {
      "command": "npx",
      "args": [
        "-y",
        "@sitharaj88/winctl"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
WINCTL_PROFILE	—	—	Permission profile: readonly (observation only), standard (adds desktop interaction and file access), or full (adds process control and shell execution). Defaults to standard.
WINCTL_TIERS	—	—	Comma-separated capability tiers, overriding the profile. Any of: observe, interact, filesystem, manage, shell.
WINCTL_ALLOWED_PATHS	—	—	Semicolon-separated folders that file tools may access. Empty means the whole filesystem except protected Windows system directories.
WINCTL_CONFIRM_DESTRUCTIVE	—	—	Set to false to skip user confirmation prompts for destructive actions. Defaults to true.
WINCTL_AUDIT_LOG	—	—	Path to the JSONL audit log. Defaults to %LOCALAPPDATA%\winctl\audit.jsonl.
WINCTL_MAX_IMAGE_WIDTH	—	—	Screenshots are downscaled to at most this width in pixels. Defaults to 1600.