# ffmpeg-skill

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9324 repo stars
- Author: kajisho5
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kajisho5/ffmpeg-skill
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ffmpeg-skill

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ffmpeg-skill -- npx -y ffmpeg-skill
```

### Codex

**Platform CLI**
```bash
codex mcp add ffmpeg-skill -- npx -y ffmpeg-skill
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ffmpeg-skill": {
            "command": "npx",
            "args": [
                "-y",
                "ffmpeg-skill"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ffmpeg-skill": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "ffmpeg-skill"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ffmpeg-skill npx -y ffmpeg-skill
```

## When to use it
- 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
- Trim `interview.mp4` from 00:12 to 00:48 and save it as `interview-cut.mp4`.
- Remove silent sections from `podcast.wav` and normalize its loudness.
- Reframe `clip.mp4` to a vertical 9:16 format.

## Similar
- [ffmpeg](https://affpapa.org/en/nevibecode/skills/ffmpeg.md) — skill · 16500 installs
- [ffmpeg-analyse-video](https://affpapa.org/en/nevibecode/skills/ffmpeg-analyse-video.md) — skill · 1900 installs
- [ffmpeg-video-editor](https://affpapa.org/en/nevibecode/skills/ffmpeg-video-editor.md) — skill · 844 installs
- [ffmpeg-captions-subtitles](https://affpapa.org/en/nevibecode/skills/ffmpeg-captions-subtitles.md) — skill · 634 installs
- [ffmpeg-color-grading-chromakey](https://affpapa.org/en/nevibecode/skills/ffmpeg-color-grading-chromakey.md) — skill · 284 installs
- [ffmpeg-media-finishing](https://affpapa.org/en/nevibecode/skills/ffmpeg-media-finishing.md) — skill · 258 installs

From the same set: [kajisho5/ffmpeg-skill](https://affpapa.org/en/nevibecode/by/kajisho5/ffmpeg-skill.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
