macOS CLI and MCP server that lets agents capture screenshots of apps or the whole system, with optional visual analysis and UI automation.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add peekaboo -- npx -y @steipete/peekaboo-mcp~/.codex/config.toml
[mcp_servers.peekaboo]
command = "npx"
args = ["-y", "@steipete/peekaboo-mcp"]
# codex mcp add peekaboo -- npx -y @steipete/peekaboo-mcp~/.cursor/mcp.json
{
"mcpServers": {
"peekaboo": {
"command": "npx",
"args": [
"-y",
"@steipete/peekaboo-mcp"
]
}
}
}.vscode/mcp.json
{
"servers": {
"peekaboo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@steipete/peekaboo-mcp"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"peekaboo": {
"command": "npx",
"args": [
"-y",
"@steipete/peekaboo-mcp"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"peekaboo": {
"command": "npx",
"args": [
"-y",
"@steipete/peekaboo-mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"peekaboo": {
"command": "npx",
"args": [
"-y",
"@steipete/peekaboo-mcp"
]
}
}
}