MCP.so
Sign In

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

@steipete

RepositoryHomepage

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

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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

Category

Other

License

MIT

Transports

stdio

Author

steipete

Submitted by

Peter Steinberger

More Other MCP servers

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

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

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

MaxKB

1Panel-dev

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

22.0K

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