Video Tools MCP
An MCP server that gives Claude the ability to process videos: transcribe with Whisper, cut reels with FFmpeg, and manage video files.
Tools
| Tool | Description | |------|-------------| | vt_transcribe | Transcribe video audio using OpenAI Whisper, saves timestamped .md | | vt_cut_reel | Cut a segment from a video using FFmpeg (fast seek + re-encode or stream copy) | | vt_rename | Rename video + transcript following a configurable naming convention | | vt_info | Get video metadata (duration, resolution, codec, fps, size) | | vt_list | List all videos in the working directory with transcript/cut status |
Prerequisites
- Python 3.10+
- FFmpeg installed and on PATH (or set
FFMPEG_PATHenv var) - Claude Desktop or Claude Code
Quick Start
git clone https://github.com/ZZtopBR/video-tools-mcp.git
cd video-tools-mcp
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txtConfiguration
| Variable | Default | Description | |----------|---------|-------------| | VT_VIDEOS_DIR | ~/videos | Working directory for videos | | FFMPEG_PATH | ffmpeg | Path to ffmpeg binary | | FFPROBE_PATH | ffprobe | Path to ffprobe binary | | VT_PREFIX | VT | Prefix for renamed files |
Connect to Claude Desktop
{
"mcpServers": {
"video-tools": {
"command": "/path/to/venv/bin/python",
"args": ["/path/to/video-tools-mcp/src/server.py"],
"env": {
"VT_VIDEOS_DIR": "/path/to/your/videos",
"FFMPEG_PATH": "ffmpeg"
}
}
}
}Workflow
- Transcribe —
vt_transcribegenerates a timestamped.mdalongside the video - Analyze — Claude reads the transcript, identifies key segments
- Cut —
vt_cut_reelextracts each segment as a separate file - Organize —
vt_renameapplies consistent naming conventions
License
MIT
Built with OpenAI Whisper, FFmpeg, and MCP by Anthropic.
