Peekaboo

Install

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

This is third-party code. Review the repository files before installing.

What it does

Peekaboo captures the screen, windows and apps on a Mac and builds a structured UI map with element IDs. From that map the agent clicks, types, presses keys, scrolls and controls windows, menus, the Dock and dialogs. Actions can be pinned to a specific window and are often delivered in the background without switching apps. The same toolset is exposed as an MCP server over stdio, and a built-in agent runs multi-step tasks from natural-language descriptions.

Who it is for. For macOS developers and automation users who need an agent to see the screen and work with native apps.

Example request

Take a screenshot of my app window and check whether any button labels are cut off

Limitations

Requires macOS 15 or newer, and Node 22 or newer for the npm package. Needs Screen Recording and Accessibility permissions. HTTP and SSE transports are not implemented yet, only stdio. The built-in agent and image analysis need a configured model provider.

How to disable. Remove the peekaboo block from the MCP config, revoke permissions in System Settings and uninstall the CLI with brew uninstall.

MCP

Transport

stdio

Authentication

not required

Security check

• Sees the whole screen and controls input in any app
• Requires system Screen Recording and Accessibility permissions

README in short

The README shows CLI install via Homebrew, the npm package with MCP and the menu bar app. The quick start covers permission checks, a screenshot and a JSON UI map of an app. It includes a Safari automation example pinned to a window ID, an agent run and a command map by goal. MCP client setup lives in docs/MCP.md. MIT licensed.

Related