Skip to content
MCP server

OpenCaptions

Add animated word-by-word captions to videos from Claude, Cursor or the command line

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
1.3.2
Listing updated
3 days ago

About OpenCaptions

OpenCaptions is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

OpenCaptions runs the whole job on your machine: transcription, styling and rendering, with no server and no account. The first caption downloads the Parakeet Ultra speech model (about 700 MB) into ~/.cache/opencaptions, and the project reports roughly ten times faster than real time on a recent laptop. Local transcription covers 25 European languages and needs Node.js 20.10 and FFmpeg.

The agent flow is conversational. Say "caption reel.mp4 with the Bold look, in French" and it transcribes, applies a look, and saves reel.captioned.mp4 next to the source. Follow-ups such as higher up, yellow or bigger change the style, and fix_words corrects, removes or joins words while keeping timing. Output can also be SRT, VTT, transcript JSON, or captions alone over green to key out in Remotion or an editor.

To get more languages, Whisper models, a GPU and the web editor, point it at your own OpenCaptions server with OPENCAPTIONS_KEY. The package is AGPL-3.0-only and doubles as a CLI.

Install

Run in a terminal

claude mcp add opencaptions --env OPENCAPTIONS_KEY='<OPENCAPTIONS_KEY>' -- npx -y opencaptions

Add to claude_desktop_config.json

{
  "mcpServers": {
    "opencaptions": {
      "command": "npx",
      "args": [
        "-y",
        "opencaptions"
      ],
      "env": {
        "OPENCAPTIONS_KEY": "<OPENCAPTIONS_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "opencaptions": {
      "command": "npx",
      "args": [
        "-y",
        "opencaptions"
      ],
      "env": {
        "OPENCAPTIONS_KEY": "<OPENCAPTIONS_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "opencaptions": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "opencaptions"
      ],
      "env": {
        "OPENCAPTIONS_KEY": "<OPENCAPTIONS_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "opencaptions": {
      "command": "npx",
      "args": [
        "-y",
        "opencaptions"
      ],
      "env": {
        "OPENCAPTIONS_KEY": "<OPENCAPTIONS_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "opencaptions": {
      "command": "npx",
      "args": [
        "-y",
        "opencaptions"
      ],
      "env": {
        "OPENCAPTIONS_KEY": "<OPENCAPTIONS_KEY>"
      }
    }
  }
}

Configuration

  • OPENCAPTIONS_KEYAn API key from your OpenCaptions server's Account page, to caption there. Without it the package captions on this computer, with FFmpeg.
  • OPENCAPTIONS_URLYour OpenCaptions server's web address (http://localhost:5173 when only the key is set)

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

caption_video
Transcribe a video, apply a look and save the captioned file.
check_progress
Continue a long job with a server.
list_looks
List the built-in looks.
describe_style
Describe every style setting with its range.
set_style
Apply a look or style changes.
get_transcript
Get captions and every word with its index.
fix_words
Correct, remove or join words keeping timing.
save_video
Save again in another format, size or frame rate.
export_subtitles
Export SRT, VTT or transcript JSON.

What it does

Local transcription
Runs the speech model on your computer so the video stays put.
Looks and styling
Choose a built-in look and adjust any style setting in plain words.
Word fixing
Correct, remove or join words while keeping their timing.
Subtitle export
Export SRT, VTT or the transcript as JSON.
Captions-only output
Save captions over green to key out in an editor.
Server option
Use your own OpenCaptions server for more languages and a GPU.

Good for

  • Caption a short vertical video
  • Fix a misheard word without re-timing
  • Export an SRT for a video you will edit elsewhere
  • Add captions in a Remotion pipeline

Pricing

Open source

AGPL-3.0; free to run locally

Prices change. Check docs.opencaptions.app before you buy.

OpenCaptions FAQ

Does it need an account?

No. It runs on your computer with no server or account unless you choose to use your own server.

What do I need installed?

Node.js 20.10 or later and FFmpeg.

Which languages work locally?

25 European languages; a server adds every language and Whisper models.

What licence is it under?

AGPL-3.0-only.

Is OpenCaptions free?

Yes. OpenCaptions is open source, so you can use and self-host it for free.

How do I add OpenCaptions to Claude Code?

Run this command in your terminal: claude mcp add opencaptions --env OPENCAPTIONS_KEY='<OPENCAPTIONS_KEY>' -- npx -y opencaptions

What are the best alternatives to OpenCaptions?

The closest alternatives to OpenCaptions are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to OpenCaptions

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media