iterm-mcp MCP server

A Model Context Protocol server that executes commands in the current iTerm session - useful for REPL and CLI assistance

What iterm-mcp does

Summarised from the project README; check the repository for the latest details.

Tools exposed (3)

• write_to_terminal – Writes to the active iTerm terminal, often used to run a command. Returns the number of lines of output produced by the command.
• read_terminal_output – Reads the requested number of lines from the active iTerm terminal.
• send_control_character – Sends a control character to the active iTerm terminal.

Requirements

• iTerm2 must be running
• Node version 18 or greater
• Node.js (runs with npx)

How to install iterm-mcp MCP in Claude Desktop, Cursor and VS Code

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

{
  "servers": {
    "iterm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Add to config generator – combine it with other servers, or get the Windsurf format.

Listed on Socketlist – add this badge to your README:

Badge markdown[](https://socketlist.pages.dev/s/ferrislucas-iterm-mcp/)

Maintain this project? Get it featured for free during launch →

Compare with deep-research →

Related AI Models & Agents MCP servers