MCP Hub › AI & Agents › WinCtl

WinCtl MCP server

by sitharaj88 · io.github.sitharaj88/winctl

Windows desktop control for AI agents: screen, UI Automation, input, processes, files, shell.

🤖 AI & Agentsnpmv1.0.2
Open in MCP HubGitHub repository ↗Website ↗

How to install WinCtl

npm

claude mcp add winctl -- npx -y @sitharaj88/[email protected]

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

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

Environment variables:
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.

Replace placeholders in <angle brackets> with your own values. Review what a server can access before you enable it.

Details

Version
1.0.2
Published
2026-08-02
Updated
2026-08-02
Namespace
io.github.sitharaj88
Source
sitharaj88/winctl

Similar ai & agents servers