Peepit MCP Server

Give your AI agents super-vision: blazing-fast macOS screenshots, smart window targeting, and local or cloud AI image analysis—all via a friendly

Local serverstdioTypeScript

What is the Peepit MCP Server?

Give your AI agents super-vision: blazing-fast macOS screenshots, smart window targeting, and local or cloud AI image analysis—all via a friendly Node.js MCP server.

What it actually does

Ever wish your AI assistant could just look at your screen and get it? PeepIt is here to grant your digital sidekick the gift of sight—no magic wands required. Whether you're debugging a UI, capturing a bug in the wild, or just want to know what's lurking behind that mysterious window, PeepIt's got your back (and your screen).

PeepIt is a macOS-only MCP server that lets AI agents capture screenshots of your apps, windows, or the whole system—then analyze them with local or cloud-based AI models. It's like giving your AI a pair of glasses and a magnifying glass, all in one.

  • 🚀 Fast & Non-intrusive — Blink and you'll miss it—PeepIt uses Apple's ScreenCaptureKit for lightning-fast screenshots, all without hijacking your window focus or interrupting your groove
  • 🎯 Smart Window Targeting — Fuzzy matching so sharp, it'll find the right window even if you only remember half its name (we've all been there)
  • 🤖 AI-Powered Analysis — Ask questions about your screenshots and get answers from GPT-4o, Claude, or local models—because sometimes you need a second set of (robotic) eyes
  • 🔒 Privacy-First — Prefer to keep things on the down-low? Run everything locally with Ollama, or call in the cloud cavalry only when you really need it
  • 📦 Easy Installation — One-click install via Cursor, or just a quick npm/npx incantation—no arcane rituals required
  • 🛠️ Developer-Friendly — Clean JSON API, TypeScript support, and logs so comprehensive you'll wonder if PeepIt is secretly writing your memoirs

Configuration

  • macOS 14.0+ (Sonoma or later) - Node.js 20.0+ - Screen Recording Permission (don't worry, you'll be prompted—no need to go spelunking in System Settings)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Peepit MCP Server

{
  "mcpServers": {
    "peepit": {
      "command": "npx",
      "args": [
        "-y",
        "@mantisware/peepit-mcp"
      ],
      "env": {
        "PEEPIT_AI_PROVIDERS": "openai/gpt-4o,ollama/llava:latest",
        "OPENAI_API_KEY": "your-openai-api-key-here"
      },
      "toolCallTimeoutMillis": 120000
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • macOS 14.0+ (Sonoma or later) - Node.js 20.0+ - Screen Recording Permission (don't worry, you'll be prompted—no need to go spelunking in System Settings)
VariableDescriptionRequired
PEEPIT_AI_PROVIDERSConfiguration value read at startup.Optional
OPENAI_API_KEYCredential the server authenticates with.Yes
PEEPIT_LOG_LEVELConfiguration value read at startup.Optional
PEEPIT_LOG_FILEConfiguration value read at startup.Optional
PEEPIT_DEFAULT_SAVE_PATHFilesystem location the server is allowed to use.Optional
PEEPIT_CONSOLE_LOGGINGConfiguration value read at startup.Optional
PEEPIT_CLI_TIMEOUTConfiguration value read at startup.Optional
PEEPIT_CLI_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Peepit to Requirements.”
  • “Use Peepit to Configuration.”

Frequently asked questions

Give your AI agents super-vision: blazing-fast macOS screenshots, smart window targeting, and local or cloud AI image analysis—all via a friendly Node.js MCP server. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.