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.