SSyncDev

OpenScreen MCP Server

Open-source screen recorder and editor whose MCP server lets an agent record, edit and export a demo video.

Local server

What is the OpenScreen MCP Server?

A pull request with a thirty-second video is easier to review than one with three paragraphs. That is the pitch behind the OpenScreen MCP server: an agent that just built a feature can also record it, tidy the take and attach the result, using a free desktop recorder and editor licensed under MIT.

The recorder underneath

OpenScreen is a desktop app for macOS, Windows and Linux in the same category as polished demo recorders. It captures a window or the whole screen with microphone and system audio, then gives you an editor with:

  • automatic or manual zooms, including zooms that follow the cursor
  • cursor smoothing and click effects
  • on-device captions with an editable transcript you can cut from
  • crop, trim and per-segment speed, plus text, arrow and image annotations
  • backgrounds, motion blur and a webcam overlay
  • GPU-accelerated export to MP4 or GIF in several aspect ratios

An in-app AI editing assistant can apply edits described in chat, but only with a key you supply for a provider such as Claude, OpenAI, Gemini or an OpenAI-compatible endpoint. Nothing is switched on by default.

How agents use it

There are two ways in. The headless CLI records, edits the .openscreen project JSON and renders video without opening windows, with machine-readable output via --json. The MCP server, started by running the app's executable with mcp, exposes OpenScreen's editing tools to an agent.

A companion demo skill wires these together. With it, an agent plans a storyboard, records the app, edits with OpenScreen's tools, exports an MP4, checks it frame by frame and attaches it to the pull request. Asked for a launch demo, it drafts a social post and only publishes after you agree.

Installing

On macOS, Homebrew's cask or a notarised DMG; on Windows, the Microsoft Store or an unsigned installer that SmartScreen will warn about; on Linux, deb, rpm, pacman, AppImage or a Nix flake. macOS 13 or later is required, along with Screen Recording and Accessibility permissions. 8 GB of RAM is the minimum.

Things to expect

To register the OpenScreen MCP server in Claude Code you need the path to the app's executable on your system, which differs by platform. One step also needs you: after the skill connects the server, you open a new session and ask it to continue. The project is under active development, so the project format and CLI may change. macOS 15 and later periodically re-ask for screen-recording permission. For more tools that do not fit a single category, see our other integrations list, the catch-all integrations category we maintain.

How to install the OpenScreen MCP Server

claude mcp add openscreen -- "<executable>" mcp

Configuration

VariableDescriptionRequired
OPENSCREEN_DISABLE_CONTENT_PROTECTIONSet to 1 on Windows 10 with OpenScreen 2.0.0 if the recording bar cannot be clicked; the bar may then appear in recordings.Optional

Frequently asked questions

Yes. It is free for personal and commercial use under the MIT license, with nothing behind a paywall.