
makevideo
Turn Markdown or JSON scripts into narrated, captioned MP4 videos on a plain CPU
- 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.0Add to claude_desktop_config.json
{
"mcpServers": {
"makevideo": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/random00000000/makevideo:0.6.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"makevideo": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/random00000000/makevideo:0.6.0"
]
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media