How do I install the peekaboo mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `PEEKABOO_AI_PROVIDERS`, `TEXT_FIELD_ID`, `BUTTON_ID` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Peekaboo MCP Server

macOS automation MCP server with screen capture, UI interaction, and AI analysis

Remote serverstreamable-httpPython

What is the Peekaboo MCP Server?

macOS automation MCP server with screen capture, UI interaction, and AI analysis

What the server does

Peekaboo brings high-fidelity screen capture, AI analysis, and complete GUI automation to macOS. Version 3 adds native agent flows and multi-screen automation across the CLI and MCP server.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

How to install the Peekaboo MCP Server

{
  "mcpServers": {
    "peekaboo": {
      "command": "npx",
      "args": ["-y", "@steipete/peekaboo"],
      "env": {
        "PEEKABOO_AI_PROVIDERS": "your-value",
        "TEXT_FIELD_ID": "your-value",
        "BUTTON_ID": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
PEEKABOO_AI_PROVIDERS	Configuration value read at startup.	Optional
TEXT_FIELD_ID	Configuration value read at startup.	Optional
BUTTON_ID	Configuration value read at startup.	Optional

Example prompts to try

“Use Peekaboo to Pixel.”
“Use Peekaboo to Natural.”
“Use Peekaboo to Action.”

Frequently asked questions

macOS automation MCP server with screen capture, UI interaction, and AI analysis Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Peekaboo MCP Server

Puppeteer

Official

The original Chromium automation reference server — simple, screenshot-driven browser control.

Browser AutomationTypeScript★ 63.0k

Fonoster

Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.

AI & ML ServicesTypeScript★ 8.1k

Janusmcp

Local multi-account MCP broker — one endpoint, every account. Switch identity without reconnecting.

Browser AutomationRemoteTypeScript

Zin MCP Client

⚡ Lightweight, Fast, Simple, Cross Platform, CLI, Web UI and Open Web UI based MCP Client for STDIO MCP Servers, to fill the gap and provide bridge

Monitoring & ObservabilityPython

Okta

<h3>🔥 ALERT!!! A brand new re-built MCP Server now available</h3> <strong>A complete rewrite built on Anthropic's new MCP architecture pattern with

AI & ML ServicesRemotePython

Openhue

An MCP server that enables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.

AI & ML ServicesTypeScript