clickshot-mcp

Local MCP server for the ClickShot Chrome extension. It lets the Claude you're already running (Claude Code / Claude Desktop) see your recent browser activity — on your own subscription, with no API key and no billing. Everything stays on your machine.

ClickShot extension ──POST screenshot──> clickshot-mcp ──MCP──> your Claude

Run

npx clickshot-mcp            # HTTP mode on 127.0.0.1:7333

Options:

clickshot-mcp [--stdio] [--port <n>]
  (default)   HTTP mode with an /mcp endpoint (for Claude Code)
  --stdio     stdio MCP (for Claude Desktop); still opens the ingest port
  --port <n>  ingest / MCP port (default 7333, or $CLICKSHOT_PORT)

Connect Claude Code (HTTP)

npx clickshot-mcp                                                  # leave running
claude mcp add --transport http clickshot http://127.0.0.1:7333/mcp

Connect Claude Desktop (stdio)

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "clickshot": { "command": "npx", "args": ["-y", "clickshot-mcp", "--stdio"] }
  }
}

Restart Claude Desktop. The server starts automatically and also opens the extension ingest port.

Tools

• get_recent_activity(limit) — last N frames as screenshots + a log (URL, page title, clicked element/text; periodic frames are labeled)
• start_watching(task) — Claude asks to watch the user perform a task. Turns on recording + periodic frames in the extension (with a visible "Claude is watching" indicator). The MCP client prompts the user to approve this.
• stop_watching() — end the watch session
• clear_activity() — wipe the buffer

Ingest API (used by the extension)

• POST /capture — { image: base64, mimeType, meta }
• GET /health — { ok, captures, mode }

Buffers the most recent 200 captures in memory. Binds to 127.0.0.1 only.