ITerm MCP Server

@rishabkoul

About ITerm MCP Server

No overview available yet

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.

Can I use this with editors other than Cursor?

The README gives a configuration example for Cursor, but the server uses standard MCP and should work with any MCP‑compatible client.

Where does terminal output data live?

Terminal output is read from iTerm2 sessions on the local machine; no external service stores the data.

Frequently asked questions

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.

Can I use this with editors other than Cursor?

The README gives a configuration example for Cursor, but the server uses standard MCP and should work with any MCP‑compatible client.

Where does terminal output data live?

Terminal output is read from iTerm2 sessions on the local machine; no external service stores the data.

Comments

Basic information

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.