{"type":"mcp_server","name":"iterm-mcp","description":"Iterm-mcp provides a Model Context Protocol server, granting AI models access to your iTerm session for tasks like command execution, output inspection, and REPL interaction, enhancing efficiency and control.","category":"Developer Tools","language":"TypeScript","stars":563,"forks":12,"owner":"ferrislucas","github_url":"https://github.com/ferrislucas/iterm-mcp","homepage":"https://www.npmjs.com/package/iterm-mcp","setup":"## Setup\n\nTo use with Claude Desktop, add the server config:\n\nOn macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\nOn Windows: `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"iterm-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"iterm-mcp\"\n      ]\n    }\n  }\n}\n```\n\nTo install iTerm for Claude Desktop automatically via [Smithery](https://smithery.ai/server/iterm-mcp):\n\n```bash\nnpx -y @smithery/cli install iterm-mcp --client claude\n```\n\nInstall dependencies:\n```bash\nyarn install\n```\n\nBuild the server:\n```bash\nyarn run build\n```","tools":"## Available Tools\n\n1. Efficient Token Use: iterm-mcp gives the model the ability to inspect only the output that the model is interested in.\n2. Natural Integration: You share iTerm with the model.\n3. Full Terminal Control and REPL support: The model can start and interact with REPL's as well as send control characters.\n4. Easy on the Dependencies: iterm-mcp is built with minimal dependencies and is runnable via npx.\n5. `write_to_terminal` - Writes to the active iTerm terminal, often used to run a command.\n6. `read_terminal_output` - Reads the requested number of lines from the active iTerm terminal.\n7. `send_control_character` - Sends a control character to the active iTerm terminal.","faq":null,"created_at":"2025-01-09T04:49:23+00:00","updated_at":"2025-03-28T14:24:36+00:00","source_url":"https://model-context-protocol.com/servers/iterm-model-context-protocol-command-execution","related_articles":[]}