Skip to content
MCP server

makevideo

Turn Markdown or JSON scripts into narrated, captioned MP4 videos on a plain CPU

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, macOS
Runs
Locally
Version
0.6.0
Listing updated
2 days ago

About makevideo

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

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "makevideo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/random00000000/makevideo:0.6.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "makevideo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/random00000000/makevideo:0.6.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (3)

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

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.

What it does

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

Pricing

Open source

Runs locally; no price listed

Prices change. Check random00000000.github.io before you buy.

makevideo 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 to makevideo

  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