MCP.so
Sign In

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

@steipete

Basic information

Category

Other

License

MIT

Transports

stdio

Author

steipete

Submitted by

Peter Steinberger

About Peekaboo MCP – lightning-fast macOS screenshots for AI agents

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.

Peekaboo MCP – lightning-fast macOS screenshots for AI agents config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "peekaboo": {
      "command": "npx",
      "args": [
        "-y",
        "@steipete/peekaboo-mcp"
      ],
      "env": {
        "PEEKABOO_AI_PROVIDERS": "ollama/llava:latest"
      }
    }
  }
}

Peekaboo MCP – lightning-fast macOS screenshots for AI agents tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Peekaboo MCP?

Peekaboo MCP is the MCP server component of Peekaboo, a macOS automation tool that provides high-fidelity screen capture, AI analysis, and complete GUI automation for AI agents. It integrates with AI coding tools such as Codex, Claude Code, and Cursor.

How to use Peekaboo MCP?

Install via npx -y @steipete/peekaboo (requires Node 22+). Configure in your MCP client settings using the provided JSON snippet. Optionally set AI providers via the PEEKABOO_AI_PROVIDERS environment variable or the peekaboo config add command.

Key features of Peekaboo MCP

  • Pixel-accurate captures (windows, screens, menu bar) with optional Retina scaling.
  • Natural-language agent that chains Peekaboo tools (see, click, type, scroll, hotkey, etc.).
  • Action-first UI automation with background input by default when a target process is known.
  • Direct accessibility tools for settable values and named actions (set-value, perform-action).
  • Multi-provider AI through Tachikoma, including hosted, local, and API-compatible providers.
  • MCP server for Codex, Claude Code, and Cursor plus a native CLI.

Use cases of Peekaboo MCP

  • Automate complex macOS workflows via natural language commands

Comments

More Other MCP servers