---
slug: "winterm"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/capecoma/winterm-mcp@master/README.md"
repo: "https://github.com/capecoma/winterm-mcp"
source_file: "README.md"
branch: "master"
---
# 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

## Installation

1. **Clone the Repository**:
   ```bash
   git clone https://github.com/capecoma/winterm-mcp.git
   cd winterm-mcp
   ```

2. **Install Dependencies**:
   ```bash
   npm install
   ```

3. **Build the Project**:
   ```bash
   npm run build
   ```

4. **Configure Claude Desktop**:

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

```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.
```json
{
  "command": "echo Hello, World!"
}
```

### read_terminal_output
Reads the specified number of lines from terminal output.
```json
{
  "linesOfOutput": 5
}
```

### send_control_character
Sends a control character to the terminal (e.g., Ctrl+C).
```json
{
  "letter": "C"
}
```

## Development

For development with auto-rebuild:
```bash
npm run dev
```

## License

MIT License - see [LICENSE](https://github.com/capecoma/winterm-mcp/tree/HEAD/LICENSE) file.