Screeny MCP Server

A **privacy-first, macOS-only MCP server** that enables AI agents to capture screenshots of pre-approved application windows, providing secure visual

Local serverstdioPython

What is the Screeny MCP server?

Screeny MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. A privacy-first, macOS-only MCP server that enables AI agents to capture screenshots of pre-approved application windows, providing secure visual context for development and debugging tasks.

What the assistant can call

Once Screeny is connected, these are the calls the assistant has available:

  • listWindows — Lists all approved application windows available for screenshot capture
  • takeScreenshot — Captures a screenshot of a specific window by its ID
  • Resources — The Resources tool exposed by this server
  • Cursor — 1. Open Cursor settings → Tools & Integrations → MCP Tools 2. Add configuration 3. Restart Cursor after saving config

Configuration and credentials

  • Python 3.10+ - macOS - Screen Capture permission

Setting it up

ENOENT on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

Among the browser automation options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Screeny's toolset — listWindows, takeScreenshot, Resources and 1 more — is a fair guide to whether it matches your workflow. It is maintained by rohanrav; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the screeny mcp server does with a few real requests.

Available tools

ToolWhat it does
listWindowsLists all approved application windows available for screenshot capture.
takeScreenshotCaptures a screenshot of a specific window by its ID.
ResourcesThe Resources tool exposed by this server.
Cursor1. Open Cursor settings → Tools & Integrations → MCP Tools 2. Add configuration 3. **Restart Cursor** after saving config

How to install the Screeny MCP server

{
  "mcpServers": {
    "screeny": {
      "command": "mcp-server-screeny",
      "args": []
    }
  }
}

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

Configuration

  • Python 3.10+ - macOS - Screen Capture permission

Example prompts to try

  • Use Screeny to listWindows.
  • Use Screeny to takeScreenshot.
  • Use Screeny to Resources.

Frequently asked questions

It connects Screeny to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (listWindows, takeScreenshot, Resources, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Screeny directly.