Win Cli MCP Server

MCP server for Windows CLI interactions

Local serverstdio

What is the Win Cli MCP server?

MCP server for Windows CLI interactions. Exposed over MCP by the win cli mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

See the API section for more details on the tools and resources the server provides to MCP clients.

  • Multi-Shell Support — Execute commands in PowerShell, Command Prompt (CMD), and Git Bash
  • SSH Support — Execute commands on remote systems via SSH
  • Resource Exposure — View SSH connections, current directory, and configuration as MCP resources
  • Security Controls —
  • Command and SSH command blocking (full paths, case variations)
  • Working directory validation

Adding it to your client

@simonb97/server-win-cli on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Its toolset

Everything the assistant can do here goes through one of these:

  • execute_command — Execute a command in the specified shell
  • Inputs — - shell (string): Shell to use ("powershell", "cmd", or "gitbash")
  • get_command_history — Get the history of executed commands
  • Input — limit (optional number)
  • ssh_execute — Execute a command on a remote system via SSH
  • ssh_disconnect — Disconnect from an SSH server
  • create_ssh_connection — Create a new SSH connection
  • read_ssh_connections — Read all configured SSH connections
  • update_ssh_connection — Update an existing SSH connection
  • delete_ssh_connection — Delete an SSH connection
  • get_current_directory — Get the current working directory of the server
  • Tools — The Tools tool exposed by this server

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 13 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Win Cli.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the win cli mcp server does with a few real requests.

When to reach for it

Plenty of file and storage access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Win Cli's toolset — execute_command, Inputs, get_command_history and 10 more — is a fair guide to whether it matches your workflow. It is maintained by SimonB97; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
execute_commandExecute a command in the specified shell
Inputs- shell (string): Shell to use ("powershell", "cmd", or "gitbash")
get_command_historyGet the history of executed commands
Inputlimit (optional number)
ssh_executeExecute a command on a remote system via SSH
ssh_disconnectDisconnect from an SSH server
create_ssh_connectionCreate a new SSH connection
read_ssh_connectionsRead all configured SSH connections
update_ssh_connectionUpdate an existing SSH connection
delete_ssh_connectionDelete an SSH connection
get_current_directoryGet the current working directory of the server
ToolsThe Tools tool exposed by this server.
ResourcesThe Resources tool exposed by this server.

How to install the Win Cli MCP server

{
  "mcpServers": {
    "windows-cli": {
      "command": "npx",
      "args": ["-y", "@simonb97/server-win-cli"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Win Cli to execute command.
  • Use Win Cli to Inputs.
  • Use Win Cli to get command history.

Frequently asked questions

It connects Win Cli to MCP-compatible AI assistants such as Claude and Cursor, exposing 13 tools (execute_command, Inputs, get_command_history, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Win Cli directly.