iterm-mcp

332

iterm-mcp is a Model Context Protocol server that integrates with iTerm, allowing models to interact with terminal sessions. It features efficient token usage, full terminal control, and simple integration with minimal dependencies.

iterm-mcp

A Model Context Protocol server providing access to your iTerm session.

Features

  • Efficient Token Use: Inspects specific output of interest, even for long-running commands.
  • Natural Integration: Share iTerm with the model, ask questions, or delegate tasks.
  • Full Terminal Control and REPL support: Interact with REPLs and send control characters.
  • Easy on the Dependencies: Minimal dependencies, easy to add to Claude Desktop and other MCP clients.

Safety Considerations

  • Users are responsible for safe usage.
  • No built-in safety restrictions. Monitor and manage model activity appropriately.

Tools

  • write_to_terminal writes to the active terminal.
  • read_terminal_output reads specified lines from the terminal.
  • send_control_character sends control characters to the terminal.

Requirements

  • iTerm2 must be running.
  • Node version 18 or greater required.

Installation

  • Use with Claude Desktop via config files.
  • Optionally install via Smithery.

Development

  • Install dependencies with Yarn.
  • Build and watch for development changes.

Debugging

  • Use MCP Inspector for debugging over stdio communications.