Skip to content
MCP server

ffmpeg-skill

Local FFmpeg video and audio editing tools for coding agents over MCP

Runs locallyActively maintainedStatus and history

The repository was last updated yesterday and is published under MIT.

Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
GitHub stars
6.9K
Last commit
1 day ago
Language
Python

About ffmpeg-skill

ffmpeg-skill is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ffmpeg-skill": {
      "command": "npx",
      "args": [
        "-y",
        "ffmpeg-skill"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ffmpeg-skill": {
      "command": "npx",
      "args": [
        "-y",
        "ffmpeg-skill"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

MIT licensed; no API key needed

Prices change. Check npmjs.com before you buy.

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 to ffmpeg-skill

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  3. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. Eikino

    MCP server

    Estimate where photos or video frames were taken and check media for AI generation

    • 3 tools
    • Remote
    • Freemium
    • Security