video-editor-mcp

An MCP (Model Context Protocol) server that gives Claude a full conversational video-editing toolkit — trim, crop, color grade, caption, beat-sync, stabilize, and more — built on ffmpeg, faster-whisper, and yt-dlp, with optional DaVinci Resolve and CapCut integration.

Describe the edit you want in chat; Claude calls the tools to do it.

Tools

Category	Tools
Download	`download_video` — from YouTube, Instagram, TikTok, Facebook, Vimeo, or any direct link (1000+ sites via yt-dlp)
Analysis	`get_video_info`, `detect_scenes`, `analyze_style` — probe a file or reverse-engineer a reference reel's cut pace, color mood, and orientation
Basic editing	`trim_video`, `merge_videos`, `extract_audio`, `change_speed`, `add_audio`
Visual	`color_grade` (cinematic/bright/moody/vibrant/bw/vintage presets), `add_text_overlay`, `crop_and_resize` (9:16/1:1/16:9/4:5), `stabilize_video`
AI	`auto_captions` — Whisper-based, burns in or exports `.srt`, multi-language
Smart editing	`edit_like_reference` — analyzes a reference reel's pace/color/orientation and re-cuts your footage to match, `beat_sync_edit` — cuts footage on detected music beats, `auto_best_moments` — extracts a highlight reel from long raw footage
Batch	`batch_process` — run one operation across every video in a folder
Sharing	`share_file` — upload a result and get a shareable link (gofile/transfer.sh)
DaVinci Resolve (optional)	`davinci_status`, `davinci_create_timeline` — only active if Resolve is installed
CapCut (optional)	`list_capcut_drafts`, `launch_capcut` — only active if CapCut is installed

Setup

1. Clone and install Python deps

git clone https://github.com/dr-ashraf-s-MCP-LABS/video-editor-mcp.git
cd video-editor-mcp
pip install -r requirements.txt

You'll also need ffmpeg on your PATH (or imageio-ffmpeg, which the server falls back to automatically) and yt-dlp.

2. Configure (optional)

Copy .env.example to .env and adjust if you need non-default binary locations, want to point at your own CapCut/DaVinci install, or need a cookies.txt for Instagram/Facebook downloads (export one with a browser extension like "Get cookies.txt LOCALLY").

3. Register with Claude

Add to your Claude Desktop / Claude Code MCP config:

{
  "mcpServers": {
    "video-editor": {
      "command": "python",
      "args": ["/absolute/path/to/video-editor-mcp/server.py"]
    }
  }
}

Restart Claude and start editing conversationally, e.g.: "Download this reel, match its style to my raw footage, add this music, and caption it."

Notes

download_video, output, and downloaded files land in ./downloads and ./output next to server.py by default — override with VIDEO_EDITOR_DOWNLOADS_DIR / VIDEO_EDITOR_OUTPUT_DIR.
CapCut and DaVinci Resolve tools degrade gracefully (report "not installed") if you haven't set the relevant env vars or don't have those apps.
auto_captions and batch_process's captions mode download the Whisper base model (~150MB) on first use.

License

MIT — see LICENSE.