iTerm
About
Enables direct execution of shell commands in the active iTerm tab, streamlining terminal-based workflows and automation tasks.
Details
- Author
- ferrislucas
- Repository
- ferrislucas/iterm-mcp
- GitHub stars
- 458
- Downloads
- 17,535
- License
- MIT License
- Categories
- Productivity, Other, Design, Developer Tools, AI, Frontend, Project Management
Jump to
Efficient Token Use: iterm-mcp gives the model the ability to inspect only the output that the model is interested in. The model typically only wants to see the last few lines of output even for long running commands.
Natural Integration: You share iTerm with the model. You can ask questions about what's on the screen, or delegate a task to the model and watch as it performs each step.
Full Terminal Control and REPL support: The model can start and interact with REPL's as well as send control characters like ctrl-c, ctrl-z, etc.
Easy on the Dependencies: iterm-mcp is built with minimal dependencies and is runnable via npx. It's designed to be easy to add to Claude Desktop and other MCP clients. It should just work.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
iTermCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
iterm-mcp
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To use with Claude Desktop, add the server config:
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",
"iterm-mcp"
]
}
}
}
To install iTerm for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install iterm-mcp --client claude
write_to_terminal
Writes to the active iTerm terminal, often used to run a command. Returns the number of lines of output produced by the command.
read_terminal_output
Reads the requested number of lines from the active iTerm terminal.
send_control_character
Sends a control character to the active iTerm terminal.
- write_to_terminal - Writes to the active iTerm terminal, often used to run a command. Returns the number of lines of output produced by the command.
- read_terminal_output - Reads the requested number of lines from the active iTerm terminal.
- send_control_character - Sends a control character to the active iTerm terminal.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"iterm": {
"cwd": "string",
"env": {},
"args": [
"-y",
"iterm-mcp"
],
"shell": false,
"command": "npx"
}
}
}
Linux
{
"cwd": "string",
"env": [],
"args": [
"-y",
"iterm-mcp"
],
"shell": false,
"command": "npx"
}
Macos
{
"cwd": "string",
"env": [],
"args": [
"-y",
"iterm-mcp"
],
"shell": false,
"command": "npx"
}
Windows
{
"cwd": "string",
"env": [],
"args": [
"-y",
"iterm-mcp"
],
"shell": false,
"command": "npx"
}
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




