Peekaboo

Level ALocal

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.

Overview

Peekaboo is a macOS tool for screen capture, accessibility inspection, and native UI automation, available as a CLI and menu-bar app. It can take screenshots, map an app's UI into structured elements, and perform clicks and typing. An optional MCP server exposes the same toolset to AI clients, while its agent can plan multi-step workflows and use local or remote models for visual question answering.

⭐ 5.5kBrowser AutomationSwiftRepo ↗Updated 2026-11-17

Installation

MCP client config (paste into mcp.json)

{
  "mcpServers": {
    "openclaw-peekaboo": {
      "command": "npx",
      "args": [
        "-y",
        "@steipete/peekaboo",
        "mcp"
      ]
    }
  }
}

Agent install prompt

Copy and paste into Cursor / Claude / other agents to install this MCP for you

Please read this MCP repository and install it into my current environment:
https://github.com/openclaw/Peekaboo

Known working client config (can write into mcp.json):
{
  "mcpServers": {
    "openclaw-peekaboo": {
      "command": "npx",
      "args": [
        "-y",
        "@steipete/peekaboo",
        "mcp"
      ]
    }
  }
}

Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.

Related servers