Screeny

What is Screeny?

Screeny is a privacy-first MCP server that enables AI agents (such as Claude Desktop or Cursor) to capture macOS screenshots. It runs entirely locally, requires explicit user approval for each window, and deletes screenshots immediately after use.

How to use Screeny?

Install via pipx install mcp-server-screeny or run with uvx mcp-server-screeny. Then configure your MCP host (Claude Desktop or Cursor) with the command mcp-server-screeny (or full path to the executable). After configuration, run mcp-server-screeny --setup (or uvx mcp-server-screeny --setup) to approve which windows can be captured. Grant Screen Capture permission to both your terminal and MCP host application before running setup.

Key features of Screeny

• Only captures user‑approved windows
• All processing stays local on your machine
• Screenshots are temporary and deleted immediately after use
• Works with Claude Desktop and Cursor
• Setup includes interactive or auto‑approval of windows
• Debug mode (--debug) to test permissions and window detection

Use cases of Screeny

• AI agents describing UI issues from live screenshots of an iOS simulator
• Developers iterating on design by having Cursor capture and analyze screenshots
• Privacy‑conscious users who want an AI agent to access only specific windows
• Automating screenshot‑based reporting without leaving sensitive data on cloud servers

FAQ from Screeny

What are the system requirements?

Python 3.10+, macOS with Screen Capture permission, and your MCP host (Claude Desktop or Cursor) must also have Screen Capture permission.

How does Screeny protect my privacy?

Only windows you explicitly approve can be captured. Screenshots are processed locally and deleted immediately after the AI agent uses them.

What if I get a “spawn uvx ENOENT” error?

Replace "uvx" in your MCP config with the full path to uvx (find it with which uvx).

Why do I see “No approved windows found”?

Run the setup command (mcp-server-screeny --setup or uvx mcp-server-screeny --setup) to approve windows. Also ensure Screen Recording permission is granted to your MCP host application.