ITerm MCP Server

Name: ITerm MCP Server
Author: rishabkoul

@rishabkoul

Repository

About ITerm MCP Server

No overview available yet

#terminal #iterm2 #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "terminal": {
      "command": "npx",
      "args": [
        "iterm_mcp_server"
      ]
    }
  }
}

Tools

Open a new terminal instance

Execute a command in a specific terminal

Read the output from a specific terminal

Close a specific terminal

List all active terminals and their information

Overview

What is ITerm MCP Server?

ITerm MCP Server is a Model Context Protocol (MCP) server that enables AI assistants to interact with iTerm2 terminals on macOS. It allows creating, managing, and controlling terminal sessions programmatically through the MCP.

How to use ITerm MCP Server?

Install Node.js >=14.x, iTerm2 on macOS, then run npx iterm_mcp_server. For integration with Cursor, add the server configuration to ~/.cursor/mcp.json with the command npx and args ["iterm_mcp_server"].

Key features of ITerm MCP Server

Create and manage iTerm2 terminal sessions
Execute commands in a specific terminal
Read terminal output from any session
List all active terminals and their details
Close specific terminal sessions

Use cases of ITerm MCP Server

AI‑powered terminal automation and scripting
Remote or automated command execution in iTerm2
Programmatic monitoring of long‑running terminal tasks
Integrating AI chat assistants with live terminal workflows

FAQ from ITerm MCP Server

What does ITerm MCP Server do?

It provides an MCP interface for iTerm2, allowing AI assistants to open, control, read from, and close terminal sessions on macOS.

What are the system requirements?

Node.js >=14.x, iTerm2, and macOS (iTerm2 is macOS‑only).

How does the server handle security?

All inputs are validated using Zod schemas, commands run in isolated terminal sessions, and proper error handling and input sanitization is implemented.