Screenplay — Claude Code MCP server: features and setup
This MCP server for Claude Code records a website or desktop app and turns the session into a video. The agent plans the actions; Screenplay captures and styles them.
MIT ★ 133 updated 2026-11-15
claude mcp add agent-screenplay -- npx -y agent-screenplayWhat Screenplay does
Screenplay turns an agent-written sequence of actions into a screen-recorded video. The agent explores the interface and drafts the steps; the server runs them in a browser or desktop app, records the session, then adds cursor movement, action-following zooms, captions, and optional narration.
A scenario specifies a site address and actions such as navigation, clicks, typing, highlights, and title cards. The check command runs the steps without recording, while render can restyle a previous take. check and record execute the actions for real, so a scenario that clicks Send will send the message.
Node 20 or newer is required. Running init downloads Chromium; the npm package also carries ffmpeg and its drawing library. Screenplay contains no AI of its own and needs no model key.
What it helps with
- record a guided walkthrough of a website or app
- turn an agent's action sequence into a video
- add captions, highlights, or narration to a recording
- restyle a video without filming the scenario again
Example prompts for the agent
- Record a walkthrough of inviting a teammate in our app, with French narration.
- Make a video showing how a conversation gets handed to a human agent.
- Create a site walkthrough that highlights the important buttons.
How to install Screenplay
Platform CLI
claude mcp add agent-screenplay -- npx -y agent-screenplayPlatform CLI
codex mcp add screenplay -- npx -y agent-screenplayConfig file
{
"mcpServers": {
"screenplay": {
"command": "npx",
"args": [
"-y",
"agent-screenplay"
]
}
}
}Config file
{
"servers": {
"screenplay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agent-screenplay"
]
}
}
}Platform CLI
gemini mcp add screenplay npx -y agent-screenplayStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Screenplay
How do I install Screenplay in Claude Code?
Run claude mcp add agent-screenplay -- npx -y agent-screenplay, then restart Claude Code.
What does Screenplay do?
It runs an agent-created scenario on a website or desktop app, records the screen, and styles the resulting video with captions, zooms, and other effects.
What does Screenplay require?
It requires Node 20 or newer. The init command downloads Chromium, while the npm package includes ffmpeg and the drawing library.