Iterm MCP

🚀 iterm-mcp

A Model Context Protocol (MCP) server that provides access to your iTerm sessions.

🚀 Quick Start

iterm-mcp is a Model Context Protocol (MCP) server that offers access to your iTerm sessions. It allows seamless interaction between models and iTerm, enabling efficient use of tokens and full - fledged terminal control.

✨ Features

• Efficient Token Usage: iterm-mcp enables the model to view only the output it's interested in. Typically, the model only wants to see the last few lines of a command's output, even for long - running commands.
• Natural Integration: You can share your iTerm with the model. You can inquire about what's on the screen or delegate tasks to the model and watch it execute each step.
• Full Terminal Control and REPL Support: The model can start and interactively use a REPL (e.g., Python's interactive interpreter) and send control characters (such as ctrl - c, ctrl - z, etc.).
• Lightweight Dependencies: iterm-mcp is built on a small number of dependencies and can be run directly via npx. It's designed to be added to Claude Desktop and other MCP clients and should work out of the box.

📚 Documentation

Security Considerations

⚠️ Important Note

• Users are responsible for ensuring the safe use of the tool.
• No Built - in Restrictions: iterm-mcp doesn't attempt to evaluate the safety of commands.
• The model's behavior can be unpredictable. Users need to monitor activities and terminate operations if necessary.
• For multi - step tasks, you may need to intervene when the model goes off - track. It's recommended to start with smaller, focused tasks until you're familiar with the model's behavior.

Tools

Requirements

• iTerm2 must be running.
• Node.js version 18 or higher.

📦 Installation

To use with Claude Desktop, add the following configuration to the corresponding configuration file:

• On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• On Windows: %APPDATA%/Claude/claude_desktop_config.json

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