# mcp-server-iterm2

> mcp-server-iterm2 — r6e-mcp-server-iterm2. Use this tool when you need to integrate AI agents with iTerm2 for observation and annotation, allowing agents to inspect and decorate sessions without disrupting the user's workflow. It solves problems related to monitoring and annotating terminal sessions, providing a non-intrusive interface for agents to interact with iTerm2. The tool accepts agent requests as input and outputs decorated session information, ideal for use cases involving automated logging, notification, or visualization in development environments like git.

Canonical page: https://skillsregistry.net/skills/r6e-mcp-server-iterm2  
JSON: https://api.skillsregistry.net/v1/skills/r6e-mcp-server-iterm2

## Description

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.

## Trust

- **Trust score (0–1):** 0.64
- **Verification tier:** scanned
- **Last scanned:** 2026-09-01

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** container
- **Runtime environment:** vm
- **Category:** other
- **Updated:** 2026-09-28

## Source

- **Source listing:** [GitHub](https://github.com/r6e/mcp-server-iterm2)

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "r6e-mcp-server-iterm2"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/r6e-mcp-server-iterm2` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/r6e-mcp-server-iterm2/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt