# iTerm MCP

Access your iTerm session and control terminal commands seamlessly.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add lite/iterm-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list lite/iterm-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get lite/iterm-mcp write_to_terminal

# Call a tool
npx -y @smithery/cli@latest tool call lite/iterm-mcp write_to_terminal '{}'
```

## Tools (3)

- `write_to_terminal` — Writes text to the active iTerm terminal - often used to run a command in the terminal
- `read_terminal_output` — Reads the output from the active iTerm terminal
- `send_control_character` — Sends a control character to the active iTerm terminal (e.g., Control-C)

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get lite/iterm-mcp <tool-name>
```

---

Source: https://github.com/lite/iterm-mcp | License: MIT