screencraft-mcp

Let your AI agent record and produce polished screen videos.

This is the MCP server for ScreenCraft, the macOS screen studio. An agent (Claude Code, Cursor, or any MCP client) starts a recording, drives a demo, stops — and exports a finished MP4 with cinematic auto-zoom generated from the agent's real clicks. No human editing.

agent clicks  →  ScreenCraft films  →  polished MP4

Requirements

• macOS (Apple Silicon), ScreenCraft ≥ 1.1.1 installed with Screen Recording permission granted
• Node 18+

Setup

Claude Code:

claude mcp add screencraft -- npx -y screencraft-mcp

Or in any MCP client config:

{
  "mcpServers": {
    "screencraft": { "command": "npx", "args": ["-y", "screencraft-mcp"] }
  }
}

Tools

| Tool | What it does | |---|---| | start_recording | Starts capture; returns once frames are actually being written. Options: project, display, mic, system audio, webcam, fps, max_duration_seconds safety cap (default 30 min). | | stop_recording | Finalizes the take (files, cursor/click telemetry, editor proxy) and returns its recording_id. | | cancel_recording | Stop and discard — for demos that went wrong. | | export_recording | Kicks off the render (auto-zoom from real clicks, cursor smoothing, background canvas) and returns an export_id immediately. | | get_status | State machine, ui_busy (human is recording), export progress → output path, attached displays, permission health. | | list_recordings | Recent takes across all projects, newest first. |

Typical workflow:

start_recording {"project": "Docs Demos"}
… drive the demo (browser automation, CLI, anything) …
stop_recording            → { recording_id: "…" }
export_recording          → { export_id: "…" }
get_status (poll)         → { export: { progress: 1, output: "/…/demo.mp4" } }

Safety by design

• Visible: the ScreenCraft menu bar shows "🤖 Agent is recording" with a human Stop button whenever an agent capture runs.
• Bounded: recordings auto-stop after max_duration_seconds (default 30 min) if the agent disappears.
• Scoped: exports only accept recordings from the ScreenCraft library — an agent can't feed arbitrary files through the render pipeline.
• Local-only: a user-owned Unix socket (0600); nothing listens on the network.

License

MIT