ffmpeg-skill — Claude Code MCP server: features and setup
This MCP server for Claude Code edits local video and audio with FFmpeg. It handles tasks such as trimming clips, removing silence, adjusting aspect ratios, and checking exports.
MIT ★ 9,324 updated 2026-11-16
claude mcp add ffmpeg-skill -- npx -y ffmpeg-skillWhat ffmpeg-skill does
The server gives an agent tools to process media locally and inspect the result. It can trim or join clips, remove silent sections, add captions and graphic overlays, sync audio with drift correction, adjust loudness, check deliverables, and render batches from folders. Video can also be reframed to a target aspect ratio.
Files stay on the machine rather than going to a cloud service. The server relies on ffmpeg and ffprobe, and python3 must also be available; all three need to be on PATH. It starts through npx and does not require an API key.
What it helps with
- trim a recording and join selected clips
- remove pauses from an audio track
- reframe footage for a vertical aspect ratio
- add captions or graphic overlays to a video
- inspect an exported media file
Example prompts for the agent
- Trim
interview.mp4from 00:12 to 00:48 and save it asinterview-cut.mp4. - Remove silent sections from
podcast.wavand normalize its loudness. - Reframe
clip.mp4to a vertical 9:16 format.
How to install ffmpeg-skill
Platform CLI
claude mcp add ffmpeg-skill -- npx -y ffmpeg-skillPlatform CLI
codex mcp add ffmpeg-skill -- npx -y ffmpeg-skillConfig file
{
"mcpServers": {
"ffmpeg-skill": {
"command": "npx",
"args": [
"-y",
"ffmpeg-skill"
]
}
}
}Config file
{
"servers": {
"ffmpeg-skill": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ffmpeg-skill"
]
}
}
}Platform CLI
gemini mcp add ffmpeg-skill npx -y ffmpeg-skillStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ffmpeg-skill
How do I install ffmpeg-skill in Claude Code?
Run claude mcp add ffmpeg-skill -- npx -y ffmpeg-skill. The runtime also needs ffmpeg, ffprobe, and python3 on PATH.
What does ffmpeg-skill do?
It exposes local FFmpeg operations as MCP tools for video and audio editing. The tools cover tasks such as cutting footage, processing sound, adding captions, and checking exports.
What does ffmpeg-skill need to run?
Install ffmpeg and ffprobe, and make sure python3 is available on PATH. No API key is needed.