Peekaboo MCP – lightning-fast macOS screenshots for AI agents

Name: Peekaboo MCP – lightning-fast macOS screenshots for AI agents
Author: steipete

@steipete

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.

#screenshots #analyze #macos

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"
      }
    }
  }
}

Tools

No tools detected

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

Basic information

More Other MCP servers

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K