Skip to main content
Glama

manim-mcp

MCP server that generates 3Blue1Brown-style math videos with Manim directly inside Claude Desktop. Videos render with AI-narrated voiceover via ElevenLabs and play inline in the chat.

https://github.com/user-attachments/assets/placeholder

Quick Start

1. Get an ElevenLabs API key

Sign up at elevenlabs.io and copy your API key from the API Keys page.

2. Add to Claude Desktop

Open Settings > Developer > Edit Config and add:

{
  "mcpServers": {
    "manim": {
      "command": "npx",
      "args": ["-y", "manim-mcp", "--stdio"],
      "env": {
        "ELEVEN_API_KEY": "sk_your_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

That's it. Ask Claude to "create a video on the Pythagorean theorem" and watch it render.

Related MCP server: Video MCP

Requirements

  • Node.js 18+ — for running the MCP server

  • Python 3.9+ — for Manim rendering (auto-installed into ~/.manim-mcp/.venv on first run)

  • ffmpeg — for video concatenation (brew install ffmpeg on macOS)

  • ElevenLabs API key — for AI voiceover

Python dependencies (manim, manim-voiceover, elevenlabs) are automatically installed on first run. This takes ~20 seconds and only happens once.

How it Works

You: "create a video on eigenvalues"

Claude plans 2-4 scenes with narration scripts
  -> writes Manim Python code for each scene
  -> calls render_video with all scenes
  -> server auto-fixes common issues (wrong TTS service, LaTeX, colors)
  -> scenes render in parallel with ElevenLabs voiceover
  -> concatenated into one video
  -> inline video player appears in chat

The server provides comprehensive Manim reference and 3Blue1Brown style guidelines in its instructions, so Claude generates good animation code. A fixGeneratedCode step silently corrects common mistakes before rendering:

  • Wrong TTS service (GTTSService, etc.) -> ElevenLabsService with correct config

  • LaTeX classes (MathTex, Tex) -> Text() with Unicode

  • Invalid colors (CYAN) -> TEAL

  • Invented APIs (set_speech_synthesizer) -> correct set_speech_service

Development

git clone https://github.com/zcsabbagh/manim-mcp.git
cd manim-mcp
npm install
npm run build

# Point Claude Desktop at local build:
# "command": "node",
# "args": ["/path/to/manim-mcp/dist/index.js", "--stdio"]

License

MIT

Available Tools

2 tools
render_videoRender Manim VideoA

Render one or more Manim scenes in parallel, concatenate them, and return one combined video inline. Each scene has complete Python code with voiceover baked in via manim-voiceover. Scenes render concurrently — voice is generated and synced during rendering automatically. The server auto-fixes common issues: wrong TTS service → ElevenLabs, CYAN → TEAL, MathTex → Text.

Inputs: scenes (required), quality. Returns: scenes, overview, videoUri, durationSeconds

show_demo_videoShow Demo VideoA

Show a pre-rendered demo video inline to test the MCP video player. No generation needed.

Inputs: no named parameters. Returns: scenes, overview, videoUri, durationSeconds

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 2 tools

    Disambiguation5/5

    render_video and show_demo_video are clearly distinct: one creates a video from user-provided scenes, the other displays a pre-rendered demo. There is no overlap in purpose or output.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern (render_video, show_demo_video), making the API predictable and easy to navigate.

    Tool Count3/5

    With only two tools, the server feels minimal for a video rendering domain, but it targets a narrow use case (rendering with voiceover and demoing), so it is borderline acceptable.

    Completeness3/5

    The server lacks operations like listing available scenes, rendering individual scenes without concatenation, or retrieving prior renders, leaving notable gaps for agents needing more granular control over the rendering process.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers