# ffmpeg-skill

> ffmpeg-skill is an open-source MCP server for design and media. Local FFmpeg video and audio editing tools for coding agents over MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://www.npmjs.com/package/ffmpeg-skill
- **Repository:** https://github.com/kajisho5/ffmpeg-skill
- **GitHub stars:** 6,934
- **License:** MIT
- **MCP Registry name:** io.github.kajisho5/ffmpeg-skill
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

ffmpeg-skill gives coding agents a set of local video and audio editing tools built on ffmpeg and ffprobe. The README says it ships 42 tools covering cuts, joins, silence removal, captions, loudness, format fitting and delivery checks.

It works as an agent skill and as an MCP server over stdio, installed with npx. It needs ffmpeg and Python 3 on your path, uses only the Python standard library, and processes footage on your machine without an account or API key. A core set of 12 tools is advertised by default, with an environment variable to list all.

It is aimed at developers who want an agent to edit and then check video output.

## Features

- **Local processing:** Runs offline, so footage stays on your machine.
- **Edit tools:** Cut, join, remove silence, fit aspect ratio and add captions.
- **Audio tools:** Loudness, clean-up and sync with drift correction.
- **Verification step:** Includes checks to verify output after an edit.
- **Machine-readable contract:** Tool schemas derive from the CLI parsers.
- **No API keys:** Needs no account or cloud service.

## Good for

- Cut silences from a recording
- Reformat a clip to vertical aspect ratio
- Burn captions into a video
- Normalize loudness before delivery
- Batch process a folder of clips

## Install

### Claude Code (Terminal)

```sh
claude mcp add ffmpeg-skill -- npx -y ffmpeg-skill
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ffmpeg-skill": {
      "command": "npx",
      "args": [
        "-y",
        "ffmpeg-skill"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ffmpeg-skill": {
      "command": "npx",
      "args": [
        "-y",
        "ffmpeg-skill"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ffmpeg-skill": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ffmpeg-skill"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ffmpeg-skill": {
      "command": "npx",
      "args": [
        "-y",
        "ffmpeg-skill"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ffmpeg-skill": {
      "command": "npx",
      "args": [
        "-y",
        "ffmpeg-skill"
      ]
    }
  }
}
```

## FAQ

### What do I need installed?

ffmpeg and python3 on your PATH.

### Does it upload my video?

No, it runs locally with no cloud.

### How many tools are there?

42 in total; 12 core tools are advertised by default.

### Is ffmpeg-skill free?

Yes. ffmpeg-skill is open source, so you can use and self-host it for free.

### How do I add ffmpeg-skill to Claude Code?

Run this command in your terminal: claude mcp add ffmpeg-skill -- npx -y ffmpeg-skill

### What are the best alternatives to ffmpeg-skill?

The closest alternatives to ffmpeg-skill are HyperFrames by HeyGen, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt, VfxSmith and CalderFlow.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [PugSoda](https://ai-powered.com/mcp/pugsoda): PugSoda is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/ffmpeg-skill
