Advertise
MCP.so
Sign In

ITerm MCP Server

@rishabkoul

Repository

Basic information

Category

Other

License

ISC

Transports

stdio

Author

rishabkoul

About ITerm MCP Server

No overview available yet

#terminal#iterm2#mcp-server

ITerm MCP Server config

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

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

ITerm MCP Server tools

5

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

Frequently asked questions

1

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.

2

What are the system requirements?

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

3

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.

4

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.

5

Where does terminal output data live?

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

Comments

More Other MCP servers

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

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.

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K
Advertise