1. Conduid
  2. Developer Tools
  3. iTerm MCP Server
MCP server · Developer Tools

iTerm MCP Server

by · github.com/rishabkoul/iTerm-MCP-Server

A Model Context Protocol (MCP) server implementation for iTerm2 terminal integration. Able to manage multiple iTerm Sessions.

Unclaimed ISC last commit a year ago devtools
InstallView source
50Fair

Scored 5 months ago · breakdown

About iTerm MCP Server

iTerm MCP Server is an MCP server published by rishabkoul in the Developer Tools category: a Model Context Protocol (MCP) server implementation for iTerm2 terminal integration. Able to manage multiple iTerm Sessions.

The repository has 14 stars and 5 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

Claude Code
claude mcp add iterm-mcp-server -- npx -y iterm_mcp_server
npx
npx -y iterm_mcp_server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (5)

close_terminalClose a specific terminal

Parameters not published.

execute_commandExecute a command in a specific terminal

Parameters not published.

list_terminalsList all active terminals and their information

Parameters not published.

open_terminalOpen a new terminal instance

Parameters not published.

read_outputRead the output from a specific terminal

Parameters not published.

Ask AI

✦

Ask AI about iTerm MCP Server

Powered by Claude · Grounded in docs

I know everything about iTerm MCP Server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • !Dependencies pinnedNo lockfile. Installs can pull different code over time.
  • !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

ITerm MCP Server

A Model Context Protocol (MCP) server implementation for iTerm2 terminal integration. This server allows AI assistants to interact with iTerm2 terminals through the Model Context Protocol.

Features

  • Create and manage iTerm2 terminal sessions
  • Execute commands in terminals
  • Read terminal output
  • List active terminals
  • Close terminals

Requirements

  • Node.js >= 14.x
  • iTerm2
  • macOS (since iTerm2 is macOS-only)

Configuration

Standard Configuration

The server uses the standard MCP configuration options. No additional configuration is required.

Cursor Configuration

To use this server with Cursor, add the following configuration to your ~/.cursor/mcp.json file:

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

Tools

  • open_terminal: Open a new terminal instance
  • execute_command: Execute a command in a specific terminal
  • read_output: Read the output from a specific terminal
  • close_terminal: Close a specific terminal
  • list_terminals: List all active terminals and their information

Security Considerations

  • The server validates all input using Zod schemas
  • Commands are executed in isolated terminal sessions
  • Proper error handling and input sanitization is implemented

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

ISC

Author

Rishab Koul

README fetched from the repository 7 days ago. The original is authoritative.

Questions

About iTerm MCP Server

How do I install iTerm MCP Server?

Run claude mcp add iterm-mcp-server -- npx -y iterm_mcp_server, then add the server to your MCP client's configuration.

Is iTerm MCP Server safe to use with an AI agent?

Its trust score is 50 out of 100 (fair). It passes 2 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is iTerm MCP Server still maintained?

The last commit was a year ago and 3 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.