iterm-mcp

A Model Context Protocol (MCP) server that allows language models to interact with your iTerm2 session.

Features

Efficient Token Use: Inspects only relevant terminal output, optimizing token usage for models.

Natural Integration: Enables seamless interaction between the model and your iTerm session, allowing you to ask questions or delegate tasks.

Full Terminal Control and REPL support: Provides complete control over the terminal, including REPL interaction and sending control characters.

Easy on the Dependencies: Built with minimal dependencies and runnable via npx, designed for easy integration with Claude Desktop and other MCP clients.

<a href="https://glama.ai/mcp/servers/h89lr05ty6"><img width="380" height="200" src="https://glama.ai/mcp/servers/h89lr05ty6/badge" alt="iTerm Server MCP server" /></a>

Safety Considerations

• The user is responsible for safe usage.
• No built-in safety restrictions; monitor model activity and abort if needed.
• Start with small tasks to understand model behavior.

Tools

• write_to_terminal: Writes to the active terminal, returning the number of output lines.
• read_terminal_output: Reads a specified number of lines from the terminal.
• send_control_character: Sends control characters to the terminal.

Requirements

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

Installation

Instructions for adding the server config to Claude Desktop are provided for macOS and Windows.

Instructions for installing via Smithery are provided.

Development

Instructions for installing dependencies, building the server, and running in watch mode are provided.

Debugging

Instructions for debugging using the MCP Inspector are provided.