mcp-server-iterm2

r6e/mcp-server-iterm2

★ 0 stars Python 🤖 AI/LLM Updated 4d ago

A Model Context Protocol (MCP) server that exposes iTerm2 to agents for observation and non-destructive annotation. Agents can inspect sessions and decorate them (badge, title, tab color, user variables, notifications) but cannot inject keystrokes, close or spawn sessions, or otherwise alter the user's working environment.

View on GitHub →

Quick Install

Copy the config for your editor. Some servers may need additional setup — check the README.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-server-iterm2": {
      "command": "uvx",
      "args": [
        "mcp-server-iterm2"
      ]
    }
  }
}

Or install with pip: pip install mcp-server-iterm2

README Excerpt

A Model Context Protocol (MCP) server that exposes iTerm2 to agents for **observation** and **non-destructive annotation**. Agents can inspect sessions and decorate them (badge, title, tab color, user variables, notifications) but cannot inject keystrokes, close or spawn sessions, or otherwise alter the user's working environment.

Tools (13)

get_recent_outputget_screen_contentsget_scrollbackget_selectionget_session_infoget_variablelist_profileslist_sessionspost_notificationset_badgeset_tab_colorset_titleset_user_variable

mcp-server-iterm2

Quick Install

README Excerpt

Tools (13)

Related AI/LLM Servers