Skip to main content
Glama
Sign In
deenesjakoruzh
windows-terminal-mcp

windows-terminal-mcp

by marttinm
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

terminal-mcp

An MCP (Model Context Protocol) server that lets any LLM execute commands on a local terminal or over SSH — works on Windows and macOS.

  • Run commands via native shells (cmd/powershell/bash on Windows, zsh/bash/sh on macOS)

  • Execute remote commands over SSH with key-based authentication

  • 3-level security model: safe / confirm / blocked

Requirements

Related MCP server: Windows CLI MCP Server

Installation

git clone https://github.com/marttinm/windows-terminal-mcp.git
cd windows-terminal-mcp
pip install -e .

Configure Claude Desktop

macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "terminal": {
      "command": "python3",
      "args": ["-m", "terminal_mcp.server"]
    }
  }
}

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "terminal": {
      "command": "cmd",
      "args": ["/c", "python", "-m", "terminal_mcp.server"]
    }
  }
}

Restart Claude Desktop after saving the config.

Security

Commands fall into three categories:

Level

Behavior

Examples

Safe

Executed directly

ls, git, npm, python, curl

Dangerous

Claude warns before executing

rm, rmdir, launchctl, diskutil

Blocked

Always rejected

rm -rf /, format, shutdown, mkfs

License

MIT — see LICENSE

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Windows CLI MCP Server

      simon-ami
      A
      license
      B
      quality
      F
      maintenance
      A Model Context Protocol server that provides secure command-line access to Windows systems, allowing MCP clients like Claude Desktop to safely execute commands in PowerShell, CMD, and Git Bash shells with configurable security controls.
      9
      374 npm
      266
      MIT

    • SSH MCP Server

      vilasone455
      F
      license
      A
      quality
      D
      maintenance
      A local Model Context Protocol server that allows LLMs to securely execute shell commands on remote Linux and Windows systems via SSH connections.
      6
      10 npm
      2
      -

    • MCP Shell Server

      mako10k
      A
      license
      B
      quality
      B
      maintenance
      A secure MCP server for shell operations, terminal management, and process control, enabling AI assistants to safely execute commands and manage interactive sessions.
      13
      137 npm
      6
      MIT

    Appeared in Searches