Labsco
MCP SERVER

Screeny

by rohanrav

Let an agent see one macOS window you approved — and nothing else on screen.

Browser Automation, Control & Screenshots
Summary
Screenshots with a whitelist in front of them.

The approval list is the whole design: an agent can only see the windows you ticked, so handing over visual context is not the same as handing over your screen. Capture is backgrounded, so the window being looked at does not have to be the one in front of you — though it does have to be un-minimised.

What it is

A macOS-only Python server that screenshots application windows an agent is allowed to capture, from a list you approve during setup. Capture happens in the background, without changing window focus.

What you get
  • The approved windows listed, and only those
  • A screenshot of a specific approved window by its ID
  • Capture in the background — no focus change, no interruption to what you are doing
  • Actual pixel data at full fidelity, not OCR or text extraction
  • JPEG compression with a base64 payload cap - a Medium default, configurable and clamped between 100 and 900KB
  • Server information and configuration exposed at `screeny://info`
  • Everything run on your device, with screenshots deleted immediately after use
Requirements

macOS, plus two things granted once: Screen Capture permission, and a window approval step where you pick which windows are capturable. Minimised windows cannot be captured. Published to PyPI as `mcp-server-screeny`.

Setup effort

One command — pipx install mcp-server-screeny