Bubba, the Screenshot Bubba mascot, in a trucker cap and sunglasses.

Screenshot Bubba for agents

A Mac menu bar app that takes screenshots, marks them up and keeps them in order, for you and your AI agent. $7.99, paid once. macOS 15 or later on Apple Silicon (M1 or newer).

What ships

All of it ships inside the app.

Setup

  1. Install Screenshot Bubba.app in /Applications and open it once to finish onboarding (Screen Recording permission).
  2. Put bubba on your PATH. It ships inside the app:
    "/Applications/Screenshot Bubba.app/Contents/Helpers/bubba" install
  3. Check the setup:
    bubba doctor
    bubba doctor checks the whole setup and prints the exact fix.
  4. For Claude Code, install the skill too, with this or the button in Settings > Agents:
    bubba install --skill

What an agent receives is out of our hands, and many agents send it to their provider's servers.

Connecting a client

bubba mcp-config prints the exact registration for Claude Code, Claude Desktop and Cursor, using the real path of the bubba binary. Pick one client with --client.

Claude Code

bubba mcp-config --client claude-code
# prints, and you run:
claude mcp add --scope user bubba -- '/Applications/Screenshot Bubba.app/Contents/Helpers/bubba' mcp

Use --scope project instead to write the server into the project's .mcp.json for your team. With bubba on your PATH, the short form is:

claude mcp add --scope user bubba -- bubba mcp

Claude Desktop

  1. In Claude, open Settings > Developer and press Edit Config.
  2. Open the file it shows you, claude_desktop_config.json, in a text editor and add this block. If other servers are already listed, add the bubba entry inside the mcpServers that is already there.
    {
      "mcpServers": {
        "bubba": {
          "args": ["mcp"],
          "command": "/Applications/Screenshot Bubba.app/Contents/Helpers/bubba"
        }
      }
    }
  3. Save the file and restart Claude.

Cursor

bubba mcp-config --client cursor prints the same JSON for ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

Codex CLI

Run Codex with network access, or register the server in ~/.codex/config.toml.

codex exec -s workspace-write -c sandbox_workspace_write.network_access=true ...
[mcp_servers.bubba]
command = "/Applications/Screenshot Bubba.app/Contents/Helpers/bubba"
args = ["mcp"]

Any other stdio MCP client

The command is the bubba path and the only argument is mcp.

The 18 MCP tools

ToolsWhat they do
list_displayslist_windowsFind a target
capturecapture_scrollingScreenshot, or one tall stitched image
ocrText, with boxes
redactBlack out secrets found or rects given
annotateDraw arrows, numbered steps, callouts and more
ui_treeAccessibility tree with frames
request_user_captureYou pick the area; the agent waits
request_reviewOpens an image in the editor for you to mark up, and the agent gets the result
record_startrecord_stopRecord, and get keyframes back
library_searchlibrary_getFind past captures
collection_listcollection_getcollection_createcollection_updateKeep sets of captures

Command line

bubba capture --window 1234 --ocr --output ~/Desktop/shot.png
bubba ocr ~/Desktop/shot.png
bubba annotate ~/Desktop/shot.png spec.json --offline
bubba redact ~/Desktop/shot.png --offline --detector keys --output ~/Desktop/shot-safe.png

bubba ocr, bubba redact and bubba annotate take --offline and work on image files without the app running.

Agents should treat consent_required, consent_denied and permission_denied as "ask the user", not as something to retry.