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

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

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K