P

Peekaboo (macOS Screen Capture)

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

494 views
0 installs
Updated Nov 22, 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).

How to Install Peekaboo (macOS Screen Capture)

Install Peekaboo (macOS Screen Capture) MCP server with one click through FastMCP. Choose your preferred AI development tool below:

Claude Desktop

Click "Claude Desktop" in Quick Start

Cursor IDE

Click "Cursor IDE" in Quick Start

VS Code

Click "VS Code" in Quick Start

Alternatives to Peekaboo (macOS Screen Capture)

Looking for similar MCP servers? Browse other servers in the same categories on FastMCP, or check out the similar servers listed above.

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.

Stay ahead of the MCP ecosystem

Get the top new MCP servers, trending tools, and dev tips delivered weekly. Free, no spam, unsubscribe anytime.

Join 2,847 developers. We send one email per week.