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
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.
What You'll Need
Set these up before or after installing:
Environment variable: KDENLIVE_MCP_ALLOWED_ROOTS
Environment variable: KDENLIVE_MCP_KDENLIVE
Environment variable: KDENLIVE_MCP_MELT
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 GitHubFrom the project's GitHub README.
kdenlive-mcp
Edit videos in Kdenlive by talking to your AI assistant.
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-mcpinstalls an unrelated project from another author. The command installed iskdenlive-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 guide | Install, settings, working safely with Kdenlive, upgrade, troubleshooting |
| Clients | Tested assistants and copyable configurations |
| Tools | Every tool, its parameters and its limits |
| Compatibility | Supported Kdenlive, MLT, FFmpeg, Python and Linux versions |
| Security model | Allowed folders, process isolation, what the server never does |
| Demos | End-to-end scenarios and results with a real assistant |
| Changelog | What changed in each version, with migration notes |
| Roadmap | What is planned, up to 1.0 and after |
| Contributing | Development setup, tests, conventions |
| Security policy | How 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!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
