iterm-mcp

Iterm MCP Server

iterm-mcp connects MCP clients to an active iTerm session for CLI and REPL assistance. Users can ask about terminal output or delegate tasks while watching the model enter text, inspect results, and send control characters.

Server facts

iterm-mcp

Tech

Runtime / language
node
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
570
Last commit
Data as of

Tags

  • Claude
  • ai
  • claude ai
  • mcp
  • mcp server
  • repl

Overview

CLI tasks and interactive REPL sessions are the focus of iterm-mcp, which lets a model work in the same iTerm session as the user. Its write_to_terminal tool enters text into the active terminal and reports how many output lines a command produced. The model can then use read_terminal_output to retrieve a chosen number of lines rather than consume the entire output. A separate send_control_character tool supports interactions such as interrupting or suspending a process. Together, these tools support questions about visible terminal activity and delegated tasks whose steps the user can observe.

The project runs on Node.js, communicates over stdio, and can be configured for Claude Desktop or other MCP clients. It requires iTerm2 to be running and Node.js 18 or later. Its terminal access comes without built-in command restrictions or safety evaluation, so users are responsible for monitoring execution and stopping inappropriate activity. The README advises beginning with focused tasks and interrupting the model when a longer workflow moves off course.

iterm-mcp setup notes

  • iterm-mcp records stdio only; confirm a network transport upstream before planning remote access.

Related MCP servers