Skip to main content
Glama

WinTerm MCP

A Model Context Protocol server that provides programmatic access to the Windows terminal. This server enables AI models to interact with the Windows command line interface through a set of standardized tools.

Features

  • Write to Terminal: Execute commands or write text to the Windows terminal

  • Read Terminal Output: Retrieve output from previously executed commands

  • Send Control Characters: Send control signals (e.g., Ctrl+C) to the terminal

  • Windows-Native: Built specifically for Windows command line interaction

Related MCP server: iTerm MCP

Installation

  1. Clone the Repository:

    git clone https://github.com/capecoma/winterm-mcp.git
    cd winterm-mcp
  2. Install Dependencies:

    npm install
  3. Build the Project:

    npm run build
  4. Configure Claude Desktop:

Add the server config to %APPDATA%/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "github.com/capecoma/winterm-mcp": {
      "command": "node",
      "args": ["path/to/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Note: Replace "path/to/build/index.js" with the actual path to your built index.js file.

Available Tools

write_to_terminal

Writes text or commands to the terminal.

{
  "command": "echo Hello, World!"
}

read_terminal_output

Reads the specified number of lines from terminal output.

{
  "linesOfOutput": 5
}

send_control_character

Sends a control character to the terminal (e.g., Ctrl+C).

{
  "letter": "C"
}

Development

For development with auto-rebuild:

npm run dev

License

MIT License - see LICENSE file.

Available Tools

3 tools
read_terminal_outputC

Read the output from the terminal

Inputs: linesOfOutput (required).

send_control_characterC

Send a control character to the terminal

Inputs: letter (required).

write_to_terminalC

Write text or commands to the terminal

Inputs: command (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: reading output, sending control characters, and writing text/commands are three separate terminal operations. An agent can easily tell them apart based on their specific functions.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (read_terminal_output, send_control_character, write_to_terminal) with snake_case throughout. The naming is predictable and readable across the set.

    Tool Count4/5

    Three tools is slightly thin but reasonable for a terminal-focused server, covering core input/output and control operations. It feels minimal but not incomplete, as each tool earns its place for basic terminal interaction.

    Completeness4/5

    The tools cover the essential terminal operations: reading, writing, and control. A minor gap might be the lack of a tool for managing terminal sessions or configuration, but for basic interaction, the surface is largely complete without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • 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
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that gives AI models access to your iTerm terminal session, allowing them to read output, write commands, and send control characters.
      3
      205 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants to interact with iTerm2 terminals, allowing creation and management of terminal sessions, command execution, and reading terminal output.
      5
      89 npm
      14
      ISC
    • A
      license
      A
      quality
      F
      maintenance
      A secure Model Context Protocol server that allows AI models to safely interact with Windows command-line functionality, enabling controlled execution of system commands, project creation, and system information retrieval.
      8
      10
      MIT