steipete/Peekaboo
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.
Overview
steipete/Peekaboo is a Swift MCP server licensed under MIT. 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. Topics: ai, macos, mcp, screenshots, swift.
Ranked #140 out of 25632 indexed tools.
In the top 1% of all indexed tools.
Has 2,750 GitHub stars.
Has 14 contributors.
Actively maintained with commits in the last week.
Ecosystem
Swift MIT
aimacosmcpscreenshotsswift
Signal Breakdown
Stars 2,750
Freshness 2d ago
Issue Health 61%
Contributors 14
Dependents 0
Forks 192
Description Detailed
License MIT
How to Improve
Dependents medium impact
Matched Queries
From the README
# Peekaboo 🫣 - Mac automation that sees the screen and does the clicks. Peekaboo brings high-fidelity screen capture, AI analysis, and complete GUI automation to macOS. Version 3 adds native agent flows and multi-screen automation across the CLI and MCP server. > Note: v3 is currently in beta (3.0.0-beta4) and has a few known issues; see the changelog for details. ## What you get - Pixel-accurate captures (windows, screens, menu bar) with optional Retina 2x scaling. - Natural-language agent that chains Peekaboo tools (see, click, type, scroll, hotkey, menu, window, app, dock, space). - Menu and menubar discovery with structured JSON; no clicks required. - Multi-provider AI: GPT-5.1 family, Claude 4.x, Grok 4-fast (vision), Gemini 2.5, and local Ollama models. - MCP server for Claude Desktop and Cursor plus a native CLI; the same tools in both. - Configurable, testable workflows with reproducible sessions and strict typing. - Requires macOS Screen Recording + Accessibility permissionRead full README on GitHub →
Are you the maintainer? Claim this listing