Peekaboo
About
a macOS-only MCP server that enables AI agents to capture screenshots of applications, or the entire system.
Details
- License
- MIT
Explore
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
PeekabooCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- macOS app + CLI (Homebrew):
brew install steipete/tap/peekaboo
- MCP server (Node 22+, no global install needed):
npx -y @steipete/peekaboo
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"peekaboo": {
"peekaboo": {
"command": "npx",
"args": [
"-y",
"@steipete/peekaboo-mcp"
],
"env": {
"PEEKABOO_AI_PROVIDERS": "ollama/llava:latest"
}
}
}
}
}McpServers
{
"peekaboo": {
"command": "npx",
"args": [
"-y",
"@steipete/peekaboo-mcp"
],
"env": {
"PEEKABOO_AI_PROVIDERS": "ollama/llava:latest"
}
}
}
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.
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). - Action-first UI automation for routine clicks/scrolls, with background process-targeted input by default when a target is known. - Direct accessibility tools for settable values and named actions (set-value, perform-action).
- Menu and menubar discovery with structured JSON; no clicks required.
- Multi-provider AI through Tachikoma, including hosted, local, and OpenAI-/Anthropic-compatible providers.
- Claude Fable 5 support with 1M context and a 128K output ceiling; saved temperature/max-token settings are shared by the app and CLI and clamped to each model's capabilities.
- MCP server for Codex, Claude Code, and Cursor plus a native CLI; the same tools in both.
- Warm daemon and Peekaboo.app Bridge hosts for permission-bound automation, with distinct lease-owned sockets and local fallback.
- Configurable, testable workflows with reproducible sessions and strict typing.
- Requires macOS Screen Recording + Accessibility permissions (see docs/permissions.md).
Install
- macOS app + CLI (Homebrew): brew install steipete/tap/peekaboo
npx -y @steipete/peekaboo
Quick start
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
