Download

Install the prerequisites, then add openvidstudio to your agent: a plugin for Claude Code, one config block for everything else. Everything runs on your machine.

Source zip or clone to run from source

Apache 2.0. The zip is the current main branch, for running from source. Rendering uses Remotion, which has its own license.

Install the prerequisites

Node 20 or newer is assumed. These lines cover the rest: ffmpeg 4.0+ for sound effects and QC frames, the Chromium build Playwright drives during capture, and edge-tts for narration. Pick your platform.

Windows, PowerShell

winget install --id Gyan.FFmpeg -e
npm install playwright && npx playwright install chromium
pip install -U edge-tts

macOS, Homebrew

brew install ffmpeg
npm install playwright && npx playwright install chromium
pip install -U edge-tts

Linux, Debian or Ubuntu

sudo apt update && sudo apt install -y ffmpeg
npm install playwright && npx playwright install chromium
pip install -U edge-tts

Add it to your agent

Pick the line for where you use your agent, then restart it. Nothing to clone or build.

Claude Code, the Claude desktop Code tab, Cowork

Install the plugin. It registers the server and the four openvidstudio skills together, and updates with one command. From a shell, run the same two with claude plugin in place of /plugin.

in a session

/plugin marketplace add AnayDhawan/openvidstudio
/plugin install openvidstudio@openvidstudio

The first start installs the server once (about 330 MB, about a minute) in the background, so the tools can take a minute to appear. Later starts are instant and work offline.

Claude Desktop, the Chat tab

Chat loads a plugin's skills but not its local server, so the tools come from the app's own config file. This writes it. Quit Claude completely and start it again.

shell

npx -y @openvidstudio/mcp-server install claude-desktop

It adds only the openvidstudio entry, keeps your other servers, and saves a backup of the file first. Then restart the app.

Cursor and VS Code

One command each. Cursor gets the global config; VS Code gets this folder's .vscode/mcp.json.

shell

npx -y @openvidstudio/mcp-server install cursor
npx -y @openvidstudio/mcp-server install vscode

It adds only the openvidstudio entry, keeps your other servers, and saves a backup of the file first. Then restart the app.

Any other MCP client

Add this to the client's mcpServers block and restart it. The client starts the server with npx, so there is nothing to clone or build.

mcp.json

{
  "mcpServers": {
    "openvidstudio": {
      "command": "npx",
      "args": ["-y", "@openvidstudio/mcp-server"]
    }
  }
}

On native Windows some clients need the command wrapped: use "cmd" as the command and "/c", "npx", "-y", "@openvidstudio/mcp-server" as the args.

If you already added the server by hand, remove that entry before you install the plugin, or you will get two servers. Plugins do not load in Claude Code cloud sessions; use the npx config there.

Check the machine

44 tools should appear after the restart. Ask your agent to run preflight: it checks ffmpeg, Playwright's Chromium and whether your app is responding, and every failure names the command that fixes it.

ask your agent

run preflight against http://localhost:3000

Then ask for a video

Start your app, then say something like “build a 30 second demo video of this product”. Your agent runs the intake, drafts a beats file, and shows you the whole thing before it writes anything to disk. For a teaching video, ask for a lesson instead (“make a two minute lesson on projectile motion”). That one needs no running app, only edge-tts 7.3 or newer for the voice.

What it does from there

Or run it from source

The clone is for running from source: to contribute, or to try changes that are not in a release yet. The normal install is the npx config above. You need git, Node and pnpm (npm install -g pnpm if you do not have it).

shell

git clone https://github.com/AnayDhawan/openvidstudio.git
cd openvidstudio
pnpm install
pnpm build

Then point your client's config at your clone instead of npx, with the absolute path to dist/stdio.js:

mcp.json

{
  "mcpServers": {
    "openvidstudio": {
      "command": "node",
      "args": [
        "/path/to/openvidstudio/packages/mcp-server/dist/stdio.js"
      ]
    }
  }
}