# makevideo

> makevideo is an open-source MCP server for design and media. Turn Markdown or JSON scripts into narrated, captioned MP4 videos on a plain CPU. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, macOS, Windows, Linux, self-hosted
- **Website:** https://random00000000.github.io/makevideo/
- **Repository:** https://github.com/random00000000/makevideo
- **MCP Registry name:** io.github.random00000000/makevideo
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

Every scene in makevideo is spoken: a local neural voice (Kokoro TTS) reads the script, each scene is timed to the real audio, and ffmpeg renders the result with captions and transitions. There is no browser, GPU, API key or cloud involved, and the same voice is used on every video. Symbols such as 42%, v1.2 and $3M are read correctly.

A video is written as Markdown, where headings become scenes and quote lines become narration, or as a JSON script of typed scenes such as title, clip, bullets and decisions. A lint step flags walls of text and unsynced lists before rendering, and errors name the scene with a working example. The site reports a 74 second video re-rendering in about 28 seconds on a laptop.

Besides the command line and a JavaScript API, it runs as an MCP server for Claude Desktop, Cursor, VS Code and Codex, exposing make_video, preview_video and check_video. It also ships a Claude Code plugin and a command that writes a use-makevideo block into AGENTS.md, CLAUDE.md, Cursor rules and Copilot instructions. Output formats include vertical 1080x1920 shorts with word-by-word captions and GIF export.

## Features

- **Markdown to video:** Headings become scenes and quote lines become narration.
- **Local neural voice:** Kokoro TTS narrates every scene on the CPU, with no API key.
- **Auto-synced captions:** Scene timing follows the real audio, with an .srt file and poster frame produced.
- **Pre-render lint:** Flags walls of text and unsynced lists before rendering.
- **Scene preview sheet:** A preview command makes a contact sheet of every scene in about a second.
- **Short-form format:** A shorts format gives 1080x1920 video with big word-by-word captions.
- **Agent setup helpers:** A Claude Code plugin and a command that writes instructions into AGENTS.md, CLAUDE.md and other rule files.

## Good for

- Produce changelog or release recap videos from a Markdown file
- Make narrated game trailers and devlogs from gameplay clips
- Generate TikTok, Reels or Shorts clips programmatically
- Let a coding agent make explainer or demo videos without building a pipeline

## Install

### Claude Code (Terminal)

```sh
claude mcp add makevideo -- docker run -i --rm ghcr.io/random00000000/makevideo:0.6.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "makevideo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/random00000000/makevideo:0.6.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "makevideo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/random00000000/makevideo:0.6.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "makevideo": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/random00000000/makevideo:0.6.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "makevideo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/random00000000/makevideo:0.6.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "makevideo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/random00000000/makevideo:0.6.0"
      ]
    }
  }
}
```

## Tools

- `make_video`: Renders a narrated, captioned MP4 from a Markdown or JSON script.
- `preview_video`: Returns an image preview of the video's scenes.
- `check_video`: Checks a video script before rendering.

## FAQ

### Does it need a GPU or an API key?

No. The site says it runs on a plain CPU with a local neural voice, with no browser, API key or cloud.

### How do I add it to an MCP client?

Add the command npx -y github:random00000000/makevideo mcp to Claude Desktop, Cursor, VS Code or Codex.

### Which tools does the MCP server provide?

make_video, preview_video (which returns an image) and check_video.

### What does a render produce?

An MP4 plus an .srt caption file, a poster frame and a report file.

### Can it make vertical videos?

Yes, a shorts format outputs 1080x1920 video with word-by-word captions, plus an exported GIF.

### Is makevideo free?

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

### How do I add makevideo to Claude Code?

Run this command in your terminal: claude mcp add makevideo -- docker run -i --rm ghcr.io/random00000000/makevideo:0.6.0

### What are the best alternatives to makevideo?

The closest alternatives to makevideo 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/makevideo
