Back to Browse

Kdenlive MCP Server

by Mhbxyz
Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Inspect, edit and render Kdenlive video projects locally on Linux.

About

Inspect, edit and render Kdenlive video projects locally on Linux.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 0 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

4 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

file_system

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Colon-separated absolute directories; every file the server reads or writes must be inside them. Unset: only the user's videos directory. 'unrestricted': no limit (not recommended).Optional

Environment variable: KDENLIVE_MCP_ALLOWED_ROOTS

Absolute path of the kdenlive executable if it is not on PATH (for example an AppImage).Optional

Environment variable: KDENLIVE_MCP_KDENLIVE

Absolute path of the MLT melt executable if it is not on PATH.Optional

Environment variable: KDENLIVE_MCP_MELT

Absolute path of the ffprobe executable if it is not on PATH.Optional

Environment variable: KDENLIVE_MCP_FFPROBE

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "mcp-kdenlive": {
      "command": "uvx",
      "args": [
        "mcp-kdenlive==0.3.0"
      ],
      "env": {
        "KDENLIVE_MCP_MELT": "your-kdenlive-mcp-melt-here",
        "KDENLIVE_MCP_FFPROBE": "your-kdenlive-mcp-ffprobe-here",
        "KDENLIVE_MCP_KDENLIVE": "your-kdenlive-mcp-kdenlive-here",
        "KDENLIVE_MCP_ALLOWED_ROOTS": "your-kdenlive-mcp-allowed-roots-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

kdenlive-mcp

Edit videos in Kdenlive by talking to your AI assistant.

PyPI Python Platform: Linux only CI MCP Registry License: MIT

kdenlive-mcp is an MCP server that gives Claude, Codex, OpenCode or any MCP client a real editing toolkit for Kdenlive: cut, arrange, crossfade, add titles and subtitles, mix the sound, render, and check the result. Everything runs on your machine, and what comes out is an ordinary Kdenlive project you can open and keep editing.

[!IMPORTANT] Linux only for now. The server relies on Linux mechanisms (process and window checks, Flatpak, XDG folders). macOS and Windows are planned after 1.0 (#98).

Why kdenlive-mcp

  • Real Kdenlive projects, not a black box. Every edit is written in Kdenlive's own format: open the project in Kdenlive and every clip, crossfade, title and effect is there to adjust. Projects are checked against a real Kdenlive round trip.
  • A full editing toolkit. 37 tools: timeline cuts, moves, trims and splits; crossfades; editable titles; SRT/WebVTT subtitles; colour and fade effects; volume and audio fades; guides and markers; media relinking; rendering with Kdenlive's presets, in the background if you like.
  • Your work stays safe. Edits go to a copy unless you ask otherwise, the original is backed up before it is ever replaced, and the server refuses to write over a project that is open in Kdenlive. It only touches the folders you allow (your Videos folder by default).
  • Renders that are checked. The assistant does not just launch a render: the output is validated (streams, duration) before it is reported as done.
  • Local and private. No account, no upload, no telemetry. The server talks to your assistant over stdio and runs Kdenlive, MLT and FFmpeg on your machine.
  • Works with your assistant. Tested with Claude Code, Codex CLI, OpenCode and Grok Build CLI, and listed in the official MCP Registry.

What you can ask

"Cut a 30-second trailer from the shots in ~/Videos/holiday, with crossfades, a title and the music fading out at the end. Render it in 1080p."

"This project says media is missing. I moved everything to ~/Videos/archive: fix it."

"Import interview.srt as subtitles, add a chapter guide at each question and lower the music under the voices."

"Turn this edit into a vertical short for social media and render it."

More scenarios, played by scripts and by a real assistant, are in examples/demos.

Install

You need Linux, Python 3.11+, and Kdenlive, MLT (melt) and FFmpeg (ffprobe) installed from your distribution (the Python package does not install them):

sudo pacman -S kdenlive mlt ffmpeg          # Arch Linux, CachyOS
sudo apt install kdenlive melt ffmpeg       # Ubuntu, Debian

Then install the server and check that it finds everything:

pipx install mcp-kdenlive      # NOT "kdenlive-mcp": that PyPI name is an unrelated project
kdenlive-mcp diagnose          # exit status 1 if something required is missing

[!WARNING] The PyPI package is mcp-kdenlive. pipx install kdenlive-mcp installs an unrelated project from another author. The command installed is kdenlive-mcp.

uvx mcp-kdenlive --version                    # run without installing, with uv
python3 -m venv ~/.venvs/kdenlive-mcp && ~/.venvs/kdenlive-mcp/bin/pip install mcp-kdenlive

From source:

git clone https://github.com/mhbxyz/kdenlive-mcp.git
cd kdenlive-mcp
uv sync            # or: python -m venv .venv && .venv/bin/pip install -e .
uv run kdenlive-mcp --version

Connect your assistant

Add the server to your MCP client, using the absolute path from command -v kdenlive-mcp:

{
  "mcpServers": {
    "kdenlive": {
      "command": "/home/you/.local/bin/kdenlive-mcp",
      "env": { "KDENLIVE_MCP_ALLOWED_ROOTS": "/home/you/Videos" }
    }
  }
}

For Claude Code, in one line:

claude mcp add kdenlive -e KDENLIVE_MCP_ALLOWED_ROOTS="$HOME/Videos" -- "$(command -v kdenlive-mcp)"

Ready-made configurations for each client, a Flatpak or AppImage Kdenlive, and every setting are in the user guide and client guide.

Documentation

User guideInstall, settings, working safely with Kdenlive, upgrade, troubleshooting
ClientsTested assistants and copyable configurations
ToolsEvery tool, its parameters and its limits
CompatibilitySupported Kdenlive, MLT, FFmpeg, Python and Linux versions
Security modelAllowed folders, process isolation, what the server never does
DemosEnd-to-end scenarios and results with a real assistant
ChangelogWhat changed in each version, with migration notes
RoadmapWhat is planned, up to 1.0 and after
ContributingDevelopment setup, tests, conventions
Security policyHow to report a vulnerability

Maintainers: releasing, packaging, MCP Registry, versioning, incident response, architecture, research.

License and credits

MIT. Kdenlive is a KDE project; kdenlive-mcp is an independent project, not affiliated with KDE.

The demo uses footage and music from Big Buck Bunny, © 2008 Blender Foundation, peach.blender.org, licensed under CC BY 3.0.

Reviews

No reviews yet

Be the first to review this server!