Overview
Features
listWindows
Lists all approved application windows available for screenshot capture; only shows user-approved windows.
takeScreenshot
Captures a screenshot of a specific window by ID; runs in the background; returns full pixel data as JPEG with a configurable base64 payload cap (default Medium/250KB; 100–900KB range).
Window Approval System
Explicit user approvals for windows; approvals saved to ~/.screeny/approved_windows.json; interactive setup or auto-approve-all option.
Privacy-first, Local Processing
All processing stays on-device; no external connections; screenshots are temporary and deleted immediately after use.
Configurable Screenshot Presets
Advanced option to configure preset size (Tiny/Small/Medium/Large/XL); saved as max_b64_kb in ~/.screeny/config.json; clamped to 100–900KB; override via SCREENY_MAX_B64_KB.
Server Information Endpoint
screeny://info endpoint provides server information and configuration details.
MCP Client Integration Examples
README provides MCP client integration examples (e.g., Claude Desktop and Cursor) to configure and run Screeny with common MCP runtimes.
Who Is This For?
- AI agents:Provide privacy-preserving visual context for AI agents by supplying pre-approved macOS window screenshots.




