ffmpeg-skill
ffmpeg-skill is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Local FFmpeg video and audio tools over stdio. It has 6,099 GitHub stars, is released under the MIT license and runs locally with npx -y ffmpeg-skill.
github.com/kajisho5/ffmpeg-skill (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
Install ffmpeg-skill
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"ffmpeg-skill": {
"command": "npx",
"args": [
"-y",
"ffmpeg-skill"
]
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --transport stdio ffmpeg-skill -- npx -y ffmpeg-skillCursor
{
"mcpServers": {
"ffmpeg-skill": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ffmpeg-skill"
]
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"servers": {
"ffmpeg-skill": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ffmpeg-skill"
]
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Tools (40)
Parsed from the Tools section of the README; check the repository for the current list.
probe.pyDuration, fps (+ VFR detection), resolution, codecs, bit depth, HDR format incl.
scenes.pyScene changes, audio peaks, highlight proposals (--rank-by audio loudest, or --rank-by duration longest — both…
look.pyContact sheet, single frames, side-by-side comparison as PNG so the agent can see what it made; --safe NAME shades the…
cut.pyIn/out or multi-segment cuts, lossless -c copy first, re-encode fallback, --accurate for frame-exact video and…
join.pyConcatenate clips with xfade transitions, normalising size, fps, sample rate and channel layout (the widest clip's, or…
silence.pyDetect and remove dead air (jump cuts) with a margin around speech (--margin, 0.2 s each side); list or export the cut…
fit.pyFit to a duration (pitch-preserving speed change or trim, smooth slow-mo) and/or aspect ratio (pad, crop or --fit…
crop.pyCrop to an exact pixel rectangle (--x --y --width --height) — distinct from fit.py --fit crop, which crops to an…
cropdetect.pyMeasure existing black letterbox/pillarbox bars and report the crop.py-ready rectangle that removes them — analysis…
deinterlace.pyDeinterlace interlaced source footage (yadif), --mode frame/field, --parity
denoise.pyReduce video noise/grain (hqdn3d), --strength low/medium/high or individual spatial/temporal overrides
redact.pyBlur, pixelate, or (--mode delogo) interpolate away an exact pixel rectangle for the whole clip.
sphere.pyExtract a flat rectilinear viewport from a 360/spherical video (--yaw --pitch --roll --h-fov --v-fov); no subject…
straighten.pyRotate by an arbitrary angle for horizon correction (--degrees, --fit crop/pad) — distinct from fit.py --rotate's…
insert.pyTurn a still image into a silent, fixed-duration video clip (title card, end slate) at an exact frame size / fps, with…
background.pyGenerate a solid-colour or two-colour gradient clip at an exact size/duration — no input file; --transparent writes a…
reverse.pyReverse playback (video and, unless --no-audio, audio)
stabilize.pyTwo-pass motion stabilisation (vidstabdetect/vidstabtransform)
sequence.pyNumbered (frame%04d.png) or glob-matched still images into a video
waveform.pyRender an audio track as a waveform or spectrum visualization video (showwaves/showspectrum) — for audio-only inputs…
freeze.pyHold a frame for N seconds (--at, --hold, --mode insert/extend) — an end-card hold or a comedic beat
pad.pyAdd black/silent padding at the start and/or end of the timeline (--start, --end) — distinct from fit.py --fit pad's…
speedramp.pyStep through different constant speeds across a clip via --segment START-END:FACTOR (repeatable) — distinct from…
loop.pyRepeat a clip --times N or to a target --duration — for background loops and filling a fixed slot length; --crossfade…
broll.pyCut away to a B-roll clip over the A-roll for a window (--insert B --at T --duration D, repeatable) and come back; A's…
metadata.pyWrite container chapter markers from a TIME TITLE text file and title/artist/comment tags, every stream copied bit for…
grid.pyComposite --colsx--rows clips into one grid, each cell letterboxed and labelled with its filename by default (--label…
audio.pyVoice clean-up chain at three strengths (--voice light\
sync.pyOffset between two recordings by audio cross-correlation (1 ms, pure Python), clock-drift correction; aligned video or…
loudness.pyTwo-pass EBU R128 loudnorm to −14 LUFS / −1 dBTP or any target (--lra for the range), video stream-copied; the written…
caption.pyBurn SRT/ASS with font, size, colour, outline, position; build SRT from timed plain text; wraps to the safe area —…
overlay.pyLogos, watermarks and titles with position, time range, opacity, fades; --platform NAME keeps them clear of that…
graphics.pyLower-thirds, title cards, chapter chips, progress bars, countdowns, corner bugs, social stickers, opening hook cards…
color.pyHDR10 / HLG / Dolby Vision → SDR BT.709 tone mapping, DV layer stripping, 3D LUT (.cube), colour-tag rewriting, typed…
export.pyPresets youtube, youtube4k, reels, tiktok, shorts, linkedin, facebook, x, youtube-hdr (HEVC Main10, source HDR tags…
proxy.pySmall, low-bitrate proxy for downstream AI analysis/preview/editing decisions — resize by --width/--scale, proxy-grade…
check.pyPASS / WARN / FAIL against YouTube, Shorts, Reels, TikTok, X, LinkedIn, Facebook, broadcast and podcast specs, from…
report.pySingle-file HTML delivery report: before/after sheets, media facts, loudness, compliance, the commands run; --pack…
render.pyRender a whole edit from a declarative project.json (clips, transitions, captions, overlays including the social…
batch.pyApply a step recipe or a project to a folder with a content-hash cache; --watch; --jobs N processes several files at…
About ffmpeg-skill
Give your coding agent a video editor. Claude Code, Cursor, Codex or any MCP client edits your footage with local FFmpeg, then checks its own output. No cloud · No API keys · Python standard library
- audio-processing
- captions
- ffmpeg
- subtitles
- video
- video-editing
- agent-skills
- ai-agents
- claude-code
- codex
Similar MCP servers
More developer tools MCP servers
Ouroboros
Q00/ouroboros
Pins an acceptance spec; the verify command and expected output never enter the success contract.
Active · last commit Nov 13, 2026
Developer toolsPythonagent-device
callstack/agent-device
Open source device layer for AI agents: control mobile, web, TV, and desktop apps over MCP.
Active · last commit Nov 16, 2026
OfficialDeveloper toolsTypeScriptClaude Code Ultimate Guide
FlorianBruniaux/claude-code-ultimate-guide
Search the Claude Code Ultimate Guide and machine-readable references from any MCP client.
Active · last commit Nov 14, 2026
Developer toolsPythonXcodeBuildMCP
getsentry/MobileBuildMCP
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Active · last commit Oct 22, 2026
OfficialDeveloper toolsTypeScriptJscpd
kucherenko/jscpd
Copy/paste detector for source code. 220+ languages, Rust engine, SARIF/HTML/badge reporters, GitHub Action, MCP server for AI agents.
Active · last commit Nov 13, 2026
Developer toolsRustFallow
fallow-rs/fallow
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
Active · last commit Nov 15, 2026
Developer toolsRust
How do I install the ffmpeg-skill MCP server?
Add the command npx -y ffmpeg-skill to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is ffmpeg-skill free?
The server is open source under the MIT license, so running it is free. It does not declare any required API key.
Is ffmpeg-skill actively maintained?
The most recent commit was on Nov 15, 2026. The latest release is v3.10.1, published Nov 15, 2026. appsgit only lists MCP servers with a commit in the last six months.