Ffmpeg MCP

A Model Context Protocol (MCP) server that provides video and audio manipulation tools powered by FFmpeg. This server enables AI assistants to perform media operations like cutting videos, converting formats, removing silence, and more. Its 6 documented tools cluster into cut, image, concat, convert. It runs locally over stdio via the published package.

People connecting media tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2025-12-19 · ★ 2 · #123 OF 155 MAINTAINED MEDIA · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Ffmpeg MCP

Claude Code

claude mcp add pedromarianoalmeida-ffmpeg-mcp -- npx -y ffmpeg-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "pedromarianoalmeida-ffmpeg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ffmpeg-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package ffmpeg-mcp-server - unscoped; check the name against the project README before installing

registry namespace io.github.PedroMarianoAlmeida is GitHub-verified and matches the repo owner

03 · What Ffmpeg MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can extract a segment from a video using start time and duration, convert a static image to a video with fixed duration, convert between media formats (auto-detects from file extension), and detect and remove silent segments from video.

Capability map

Tools grouped from the project's README - what Ffmpeg MCP lets an agent do.

Cut

1 tool - e.g. Extract a segment from a video using start time and duration

cut_video

Image

1 tool - e.g. Convert a static image to a video with fixed duration

image_to_video

Concat

1 tool - e.g. Join multiple videos into one

concat_videos

Convert

1 tool - e.g. Convert between media formats (auto-detects from file extension)

convert

delete

1 tool - e.g. Detect and remove silent segments from video

remove_silence

Ffmpeg

1 tool - e.g. Execute raw FFmpeg commands for advanced operations

ffmpeg_raw

04 · Who maintains Ffmpeg MCP

ffmpeg-mcp is maintained by pedromarianoalmeida. It's the only MCP server we track from this author; the repo dates to Dec 2025.

05 · Facts

repository: github.com/pedromarianoalmeida/ffmpeg-mcp
category: media - ranked #123 of 155 actively-maintained media servers as of 2026-08-25.
registry: io.github.PedroMarianoAlmeida/ffmpeg-mcp (active, first published 2025-12-19)
packages: npm:ffmpeg-mcp-server

06 · Ffmpeg MCP FAQ

Is Ffmpeg MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2025-12-19. We re-verify nightly.

What can Ffmpeg MCP do?

How do I install Ffmpeg MCP?

Run `npx -y ffmpeg-mcp-server`. You can also paste the ready-made client config above.

Does Ffmpeg MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Ffmpeg MCP

Alternatives to Ffmpeg MCP

Maintained media servers if Ffmpeg MCP isn't the fit.

More media MCP servers · Moltdj · Photographi MCP · Image Diff · SVG Tracer · Barevalue

More TypeScript MCP servers · Pepesto MCP · P4plan MCP · Thoth MCP · Postfast MCP · Smails · see all