$ timeahead.in

mcp/iterm_mcp_server/install/windsurf

install iterm_mcp_server on Windsurf

Requires Node 18+ on your system so npx can fetch the package on first run. Windsurf supports HTTP and stdio servers natively. After saving the config, hit Refresh in the Cascade MCP panel. Paste the config below, then follow the reload step to register iterm_mcp_server.

paste into

macos/linux: ~/.codeium/windsurf/mcp_config.json

windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

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

then: Click the Refresh button in the Cascade MCP panel — no full restart.

other clients

Claude Desktop →Cursor →VS Code (Copilot) →Claude Code →

← back to iterm_mcp_server