Peekaboo

listing.by

Capture the macOS screen, inspect app UI and automate clicks and typing from your AI assistant.

state.local.long (state.local.title)listing.badge.runs_with

listing.install

listing.local.explain

npx -y @steipete/peekaboo mcp

listing.local.needs listing.local.note

act.add_to a11y.new_tabact.add_to a11y.new_tab

listing.share.h

listing.share.p_local

mcp.tc/i/peekaboo

listing.about

Peekaboo is a macOS CLI and menu-bar app for screen capture, accessibility inspection and native UI automation. Through MCP it exposes the same tools to a client: take screenshots of the screen or a single app, read a structured map of UI elements with element IDs, then click, type, press keys, scroll and drag. It also covers apps, windows, menus, the Dock and dialogs.

It runs locally over stdio, started with npx. It needs macOS 15 or later and Node.js 22 or later. No sign-in is needed for the MCP tools, though the built-in agent command needs a configured model provider. macOS Screen Recording and Accessibility permissions must be granted.

listing.can

  • Capture screenshots of the whole screen or a specific app
  • Inspect a running app's UI as structured elements with IDs
  • Click, type, press keys, scroll and drag in native apps
  • List and target specific windows by window ID
  • Control apps, menus, the Dock and dialogs
  • Check which macOS permissions are granted

listing.tools

listing.notools.local

listing.prompts

  • Take a screenshot of my screen and describe what is open

  • Inspect the Finder window and list its clickable elements

  • Open Safari, click the address bar and type github.com

  • List all Safari windows and their IDs

listing.setup.h

listing.setup.local

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport stdio peekaboo -- npx -y @steipete/peekaboo mcp
  1. Start Claude Code and type /mcp. peekaboo should show as connected.

Add --scope user to make it available in every project.

Claude Desktop

  1. Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:
claude_desktop_config.json
{
  "mcpServers": {
    "peekaboo": {
      "command": "npx",
      "args": [
        "-y",
        "@steipete/peekaboo",
        "mcp"
      ]
    }
  }
}
  1. Save the file and restart Claude Desktop.

Needs Node.js on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Cursor

Add to Cursor a11y.new_tab

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

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

Needs Node.js on your computer.

VS Code

Install in VS Code a11y.new_tab

Or from a terminal:

code --add-mcp '{"name":"peekaboo","type":"stdio","command":"npx","args":["-y","@steipete/peekaboo","mcp"]}'

Or commit it to the repo in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "peekaboo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@steipete/peekaboo",
        "mcp"
      ]
    }
  }
}

Needs Node.js on your computer.

Devin Desktop

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "peekaboo": {
      "command": "npx",
      "args": [
        "-y",
        "@steipete/peekaboo",
        "mcp"
      ]
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

Codex

codex mcp add peekaboo -- npx -y @steipete/peekaboo mcp

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.peekaboo]
command = "npx"
args = ["-y", "@steipete/peekaboo", "mcp"]

Needs Node.js on your computer.

Gemini CLI

gemini mcp add peekaboo npx -- -y @steipete/peekaboo mcp

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients that start local servers accept this shape:

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

Zed puts servers under context_servers in its settings, with the same command, args and env fields.

Needs Node.js on your computer.

listing.faq

Can I paste mcp.tc/i/peekaboo into my MCP client?

No. Peekaboo runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is npx -y @steipete/peekaboo mcp.

Does Peekaboo need an API key?

No. It doesn't declare any keys or environment variables. It runs with your user account's permissions, so check what its tools can reach.

Is Peekaboo a remote or a local server?

Local. Your client starts it as a process on your computer with npx -y @steipete/peekaboo mcp, which needs Node.js.

What can Peekaboo do?

You can capture screenshots of the whole screen or a specific app, inspect a running app's UI as structured elements with IDs and click, type, press keys, scroll and drag in native apps.

Which clients can use it?

Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.

Who wrote this page?

mcp.tc's robot read Peekaboo's public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can't confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

listing.em.h

listing.em.lead_local listing.em.how

listing.em.badge

em.prev_lightem.prev_dark
Markdown
[![Peekaboo on mcp.tc](https://mcp.tc/i/peekaboo/badge.svg)](https://mcp.tc/i/peekaboo)
HTML
<a href="https://mcp.tc/i/peekaboo"><img src="https://mcp.tc/i/peekaboo/badge.svg" alt="Peekaboo on mcp.tc" height="20"></a>

listing.em.badge_note

listing.em.widget

HTML
<script src="https://mcp.tc/w/peekaboo.js" async></script>

listing.em.widget_note

iframe

HTML
<iframe src="https://mcp.tc/embed/peekaboo" title="Peekaboo on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

listing.em.iframe_note

JSON

listing.em.json_local

https://mcp.tc/i/peekaboo.json

listing.em.fields

listing.related

listing.more_in

  • Windows-MCP

    CursorTouch

    state.local.label (state.local.title)

    Control a Windows desktop: launch apps, click, type, take screenshots, use the clipboard, run PowerShell and edit files and the registry.

    mcp.tc/i/windows-mcp

  • iMCP

    Mattt

    state.local.label (state.local.title)

    Give your assistant access to Messages, Contacts, Calendar, Reminders, Maps and Weather on your Mac.

    mcp.tc/i/imcp

  • Timevf.sr

    MCP reference servers

    state.local.label (state.local.title)

    Get the current time in any IANA timezone and convert times between timezones.

    mcp.tc/i/time

  • MarkItDownvf.sr

    Microsoft

    state.local.label (state.local.title)

    Convert PDF, Office documents, HTML, images and other files or URLs to Markdown for use in LLM context.

    mcp.tc/i/markitdown

  • Globalping

    Globalping (jsDelivr)

    state.auth.label (state.auth.title)

    Run ping, traceroute, DNS, MTR and HTTP tests from thousands of probes around the world.

    mcp.tc/i/globalping

  • Generate Random IBAN

    generaterandomiban.com

    state.ok.label (state.ok.title)

    Generate and validate structurally valid test IBANs with correct MOD-97 check digits for many countries.

    mcp.tc/i/generate-random-iban

listing.disclaimer_checked