# OpenCaptions

> OpenCaptions is an open-source MCP server for design and media. Add animated word-by-word captions to videos from Claude, Cursor or the command line. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Website:** https://docs.opencaptions.app/guides/agents/
- **Repository:** https://github.com/leogaudin/opencaptions/tree/HEAD/apps/agent
- **MCP Registry name:** io.github.leogaudin/opencaptions
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/opencaptions
