Peekaboo (macOS Screen Capture)

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).