Server facts
iterm-mcp
Project
- Author
- ferrislucas
- Repository
- github.com/ferrislucas/iterm-mcp
- License
- MIT
- Category
- Developer Tools
Tech
- Runtime / language
- node
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 570
- Last commit
- Data as of
Tags
- Claude
- ai
- claude ai
- mcp
- mcp server
- repl
Overview
CLI tasks and interactive REPL sessions are the focus of iterm-mcp, which lets a model work in the same iTerm session as the user. Its write_to_terminal tool enters text into the active terminal and reports how many output lines a command produced. The model can then use read_terminal_output to retrieve a chosen number of lines rather than consume the entire output. A separate send_control_character tool supports interactions such as interrupting or suspending a process. Together, these tools support questions about visible terminal activity and delegated tasks whose steps the user can observe.
The project runs on Node.js, communicates over stdio, and can be configured for Claude Desktop or other MCP clients. It requires iTerm2 to be running and Node.js 18 or later. Its terminal access comes without built-in command restrictions or safety evaluation, so users are responsible for monitoring execution and stopping inappropriate activity. The README advises beginning with focused tasks and interrupting the model when a longer workflow moves off course.
iterm-mcp setup notes
- iterm-mcp records stdio only; confirm a network transport upstream before planning remote access.