MCP ConfigsMay 14, 2026·2 min read

Peekaboo — macOS Screenshots + Clicks (MCP)

Peekaboo is a macOS CLI (optional MCP) for screenshots and click automation; verified 3,986★ and installs via Homebrew or `npx -y @steipete/peekaboo`.

MCP Hub
MCP Hub · Community
Agent ready

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Native · 94/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Mcp
Install
Brew|Npx
Trust
Trust: Established
Entrypoint
npx -y @steipete/peekaboo
Universal CLI install command
npx tokrepo install b15b5279-78c8-51d9-8d13-4a52914a6ebb
install contractmetadata JSONadapter planraw content
Intro

Peekaboo is a macOS CLI (optional MCP) for screenshots and click automation; verified 3,986★ and installs via Homebrew or npx -y @steipete/peekaboo.

Best for: Agent workflows that must see the screen, take evidence screenshots, and perform deterministic UI actions

Works with: macOS 15+ with Screen Recording + Accessibility permissions; MCP clients via npx

Setup time: 10-25 minutes

Key facts (verified)

  • GitHub: 3986 stars · 288 forks · pushed 2026-05-11.
  • License: MIT · owner avatar + repo URL verified via GitHub API.
  • README-backed entrypoint: npx -y @steipete/peekaboo.

Main

  • Get permissions right first: README calls out Screen Recording + Accessibility; without them, agents will fail mid-run.
  • Use screenshots as evidence: capture before/after images so agent runs can be audited and reproduced.
  • Prefer structured element IDs + actions (click, set-value, perform-action) over coordinate clicks to reduce UI flakiness.

Source-backed notes

  • README says it’s a macOS CLI and optional MCP server, exposing the same tools through both interfaces.
  • README Quick start shows commands like peekaboo image ... and an MCP server run via npx -y @steipete/peekaboo.
  • README lists a requirement for Screen Recording + Accessibility permissions (linked docs/permissions.md).

FAQ

  • Do I have to use Homebrew?: No—README also supports running the MCP server via npx -y @steipete/peekaboo.
  • Why are actions failing?: Most issues are missing permissions; confirm Screen Recording + Accessibility are enabled.
  • When should I use MCP mode?: Use MCP mode when you want agents to call tools directly from Codex/Claude Code/Cursor.
🙏

Source & Thanks

Source: https://github.com/openclaw/Peekaboo > License: MIT > GitHub: ⭐ 3986 · forks 288

Thanks to the upstream maintainers for shipping the original project.

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

Osaurus — macOS AI Harness with Sandbox + MCP

Osaurus is a native macOS AI harness for agents, memory, and tools: run local/offline models, start a server/CLI, and expose tools via an MCP server.

MCP Configs
MCP Hub

mcp-server-apple-events — macOS Reminders MCP

mcp-server-apple-events exposes macOS Reminders/Calendar actions to MCP clients via Apple Events, with an `npx` quick start and ready-to-copy configs.

MCP Configs
MCP Hub

kubernetes-mcp-server — Kubernetes Tools via MCP

kubernetes-mcp-server exposes Kubernetes operations to MCP clients with npx/uvx/binary run modes; verified 1584★ and pushed 2026-05-14.

MCP Configs
MCP Hub

Mac Messages MCP — iMessage/SMS Bridge

Mac Messages MCP is a Python MCP server for Messages.app on macOS: read chats, send replies, search attachments, and fall back to SMS/RCS.

MCP Configs
MCP Hub
◈Home🔍Search👤Me