P

Peekaboo (macOS Screen Capture)

Enables macOS screen capture and window management with tools for taking screenshots, analyzing imag...

140 views
0 installs
Updated Sep 9, 2025
Not audited
Enables macOS screen capture and window management with tools for taking screenshots, analyzing images, and controlling application windows
  1. Obtain Your OpenAI API Key

    • Visit the OpenAI API Keys page: https://platform.openai.com/api-keys.
    • Log in or create an account if needed.
    • Click the “Create new secret key” button.
    • Copy the generated API key. You will need this in the next step.
  2. Prepare AI Providers List (Optional)

    • Decide which AI providers you want to use. By default, Peekaboo uses OpenAI (openai/gpt-4o) and Ollama (ollama/llava:latest), but you can modify this as needed.
    • Example value: openai/gpt-4o,ollama/llava:latest
  3. Add Environment Variables in FastMCP

    • In the FastMCP connection interface, click the “Install Now” button to start adding the Peekaboo MCP integration.
    • Fill in the environment variables as follows:
      • OPENAI_API_KEY: Paste the API key you copied from OpenAI.
      • PEEKABOO_AI_PROVIDERS: (Optional) Set your list of providers, e.g., openai/gpt-4o,ollama/llava:latest. If unsure, leave this as the default.
  4. (Optional) Additional Environment Variables

    • Set any other variables if you have specific requirements:
      • PEEKABOO_DEFAULT_SAVE_PATH: Folder to save screenshots (e.g., ~/Desktop/Screenshots)
      • PEEKABOO_LOG_LEVEL: Adjust log verbosity (info, debug, etc.)
      • PEEKABOO_OLLAMA_BASE_URL: For a remote/local Ollama server (default: http://localhost:11434)
    • These can also be configured in the same FastMCP environment interface.
  5. Grant macOS Permissions

    • Make sure the required macOS permissions for Screen Recording are granted:
      • Go to System Settings → Privacy & Security → Screen & System Audio Recording.
      • Enable access for Terminal, Claude Desktop, or your IDE as needed.
  6. Complete Setup

    • Save and apply your changes in FastMCP.
    • If asked to restart or update the connection, do so.

You’re done! Peekaboo MCP should now be able to capture and analyze screenshots using your configured AI provider(s).

Quick Start

View on GitHub

More for Productivity

View All →

More for AI and Machine Learning

View All →

Similar MCP Servers

S

Screenshot Capture

Enables AI to capture screenshots from multiple displays on macOS, Windows, and Linux for analyzing visual content, debugging UI issues, or assisting with design tasks

Productivity Developer Tools
S

Screeny

Privacy-focused macOS MCP server for secure, user-approved window screenshots

Developer Tools

Report Issue

Thank you! Your issue report has been submitted successfully.