Windows desktop control for AI agents: screen, UI Automation, input, processes, files, shell.
Connect Runs on your machine
claude mcp add winctl -e WINCTL_PROFILE=<WINCTL_PROFILE> -e WINCTL_TIERS=<WINCTL_TIERS> -e WINCTL_ALLOWED_PATHS=<WINCTL_ALLOWED_PATHS> -e WINCTL_CONFIRM_DESTRUCTIVE=<WINCTL_CONFIRM_DESTRUCTIVE> -e WINCTL_AUDIT_LOG=<WINCTL_AUDIT_LOG> -e WINCTL_MAX_IMAGE_WIDTH=<WINCTL_MAX_IMAGE_WIDTH> -- npx -y @sitharaj88/[email protected]{
"mcpServers": {
"winctl": {
"command": "npx",
"args": [
"-y",
"@sitharaj88/[email protected]"
],
"env": {
"WINCTL_PROFILE": "<WINCTL_PROFILE>",
"WINCTL_TIERS": "<WINCTL_TIERS>",
"WINCTL_ALLOWED_PATHS": "<WINCTL_ALLOWED_PATHS>",
"WINCTL_CONFIRM_DESTRUCTIVE": "<WINCTL_CONFIRM_DESTRUCTIVE>",
"WINCTL_AUDIT_LOG": "<WINCTL_AUDIT_LOG>",
"WINCTL_MAX_IMAGE_WIDTH": "<WINCTL_MAX_IMAGE_WIDTH>"
}
}
}
}{
"mcpServers": {
"winctl": {
"command": "npx",
"args": [
"-y",
"@sitharaj88/[email protected]"
],
"env": {
"WINCTL_PROFILE": "<WINCTL_PROFILE>",
"WINCTL_TIERS": "<WINCTL_TIERS>",
"WINCTL_ALLOWED_PATHS": "<WINCTL_ALLOWED_PATHS>",
"WINCTL_CONFIRM_DESTRUCTIVE": "<WINCTL_CONFIRM_DESTRUCTIVE>",
"WINCTL_AUDIT_LOG": "<WINCTL_AUDIT_LOG>",
"WINCTL_MAX_IMAGE_WIDTH": "<WINCTL_MAX_IMAGE_WIDTH>"
}
}
}
}{
"servers": {
"winctl": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sitharaj88/[email protected]"
],
"env": {
"WINCTL_PROFILE": "<WINCTL_PROFILE>",
"WINCTL_TIERS": "<WINCTL_TIERS>",
"WINCTL_ALLOWED_PATHS": "<WINCTL_ALLOWED_PATHS>",
"WINCTL_CONFIRM_DESTRUCTIVE": "<WINCTL_CONFIRM_DESTRUCTIVE>",
"WINCTL_AUDIT_LOG": "<WINCTL_AUDIT_LOG>",
"WINCTL_MAX_IMAGE_WIDTH": "<WINCTL_MAX_IMAGE_WIDTH>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
WINCTL_PROFILEOptional | Permission profile: readonly (observation only), standard (adds desktop interaction and file access), or full (adds process control and shell execution). Defaults to standard. |
WINCTL_TIERSOptional | Comma-separated capability tiers, overriding the profile. Any of: observe, interact, filesystem, manage, shell. |
WINCTL_ALLOWED_PATHSOptional | Semicolon-separated folders that file tools may access. Empty means the whole filesystem except protected Windows system directories. |
WINCTL_CONFIRM_DESTRUCTIVEOptional | Set to false to skip user confirmation prompts for destructive actions. Defaults to true. |
WINCTL_AUDIT_LOGOptional | Path to the JSONL audit log. Defaults to %LOCALAPPDATA%\winctl\audit.jsonl. |
WINCTL_MAX_IMAGE_WIDTHOptional | Screenshots are downscaled to at most this width in pixels. Defaults to 1600. |
Details
| Package | @sitharaj88/[email protected] (NPM, stdio) |
| Package | https://github.com/sitharaj88/winctl/releases/download/v1.0.2/[email protected] (MCPB, stdio) |
| First published | 2 Aug 2026 |
| Last updated | 2 Aug 2026 |
| Registry name | io.github.sitharaj88/winctl |
More developer tools servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.