Peekaboo MCP Server

v1.0.0Developer Toolsstable

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.

aimacosmcpscreenshotsswift
Share:
4,401
Stars
0
Downloads
0
Weekly
0/5

About

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.

Features

  • image
  • analyze
  • list

Use Cases

Captures macOS screen content and optionally analyzes it. Targets can be entire screen, specific app window, or all windows of an app (via app_target). Supports foreground/background capture. Output via file path or inline Base64 data (format: 'data'
Analyzes a pre-existing image file from the local filesystem using a configured AI model. This tool is useful when an image already exists (e.g., previously captured, downloaded, or generated) and you need to understand its content, extract text, or
Lists various system items on macOS, providing situational awareness. Capabilities: - Running Applications: Get a list of all currently running applications (names and bundle IDs). - Application Windows: For a specific application (identified by name
openclaw

Maintainer

LicenseMIT
Languageswift
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y @steipete/peekaboo-mcp

Manual Installation

npx -y @steipete/peekaboo-mcp

Examples

Basic Configuration

Configure Peekaboo MCP Server

npx -y @steipete/peekaboo-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Web UI

Not available

Security

Authentication

RequiredNo

Features

Data Encryption
Audit Logging
RBAC Support

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

More Developer Tools MCP Servers

Explore other servers in the Developer Tools category.

Quick Config Preview

{ "mcpServers": { "peekaboo": { "command": "npx", "args": ["-y", "@steipete/peekaboo-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Peekaboo MCP Server?

Browse our complete directory of 60+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

60+ ServersFree & Open SourceStep-by-Step Guides