iterm-mcp

MCP server by ferrislucas · ★ 570 · updated 1 year ago

System & FilesStaleOne-click install

A Model Context Protocol server that executes commands in the current iTerm session - useful for REPL and CLI assistance

Install View on GitHub Website

Install iterm-mcp

Choose your AI client and copy the config.

Add to claude_desktop_config.json — macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Then restart Claude. Setup guide

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "iterm-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Add to Cursor

Or add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project). Setup guide

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "iterm-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Install in VS Code

Or add to .vscode/mcp.json in your workspace. Setup guide

{
  "servers": {
    "iterm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "iterm-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Cascade → Actions → Open MCP config file (often ~/.config/devin/mcp_config.json). Setup guide

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "iterm-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Run in your terminal: Setup guide

claude mcp add iterm-mcp -- npx -y @smithery/cli install iterm-mcp --client claude

CLI or add to ~/.codex/config.toml. Setup guide

codex mcp add iterm-mcp -- npx -y @smithery/cli install iterm-mcp --client claude

[mcp_servers.iterm-mcp]
command = "npx"
args = ["-y", "@smithery/cli", "install", "iterm-mcp", "--client", "claude"]

Cline panel → Configure MCP Servers, or ~/.cline/data/settings/cline_mcp_settings.json. Setup guide

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "iterm-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Run the server directly:

npx -y @smithery/cli install iterm-mcp --client claude

Before you install: Install command taken from the project README. Check the README for any required environment variables.

Related System & Files servers

Filesystem (official reference server)

by modelcontextprotocol · TypeScript

Node.js server for filesystem operations: read/write files, create/list/delete directories, move and search files, with configurable allowed directories.

System & FilesOfficialMaintained91.2k (repo)

DesktopCommanderMCP

by wonderwhy-er · JavaScript

This is MCP server for Claude that gives it terminal control, file system search and diff file editing capabilities

System & FilesMaintained10k

Windows-MCP

by CursorTouch · Python

MCP Server for Computer Use in Windows

System & FilesMaintainedRemote8.9k

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

System & FilesMaintained5.3k

wslmanager

by bostrot · Dart

GUI for the Windows Subsystem for Linux — and native Linux/macOS VMs on Mac. Install, back up, move and configure distros without CLI flags; AI assistant with tools, MCP server for agents, remote WSL over SSH.

System & FilesMaintainedRemote4k

crosspaste-desktop

by CrossPaste · Kotlin

Cross-device clipboard sync for macOS, Windows & Linux — end-to-end encrypted, LAN-only, no cloud. OCR, CLI and MCP server built in.

System & FilesMaintained2.6k