Kdenlive MCP Server
io.github.Va1bhav512/kdenlive-mcp-server·v0.1.3·5 starsKdenlive video editing MCP - 36 tools for project, timeline, filters and melt rendering
5 stars52 downloads/wk
Reviews
Write oneNobody has reviewed Kdenlive MCP Server yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Kdenlive MCP Server tools (73, 12 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
bin_create_folderwrite actionCreate folder in project bin.
bin_get_clip_detailsGet detailed properties of a bin clip (length, aspect ratio, media info).
bin_import_clipIngest a media file into the project bin for later timeline use.
bin_list_clipsList every asset in the project bin with ID, name, type, and duration.
bin_move_clipMove clip to folder (or root if folder None).
bin_remove_clipwrite actionDelete a clip from the media bin by its ID.
bin_renameRename bin clip.
clip_add_noteAdd / update note for bin clip.
clip_get_propertiesGet timeline clip properties: in/out, duration, speed, opacity, reverse.
clip_reverseReverse playback direction of a timeline clip (toggles).
clip_set_colorSet color label for bin clip (hex or named).
clip_set_opacitySet opacity of a timeline clip (0.0 transparent .. 1.0 opaque).
clip_set_speedSet playback speed of a timeline clip (1.0=normal, 2.0=2x, 0.5=half, negative=reverse).
export_list_presetsList all available render presets for final video output.
export_renderRender the project to a video file via melt.
export_xmlGenerate Kdenlive/MLT XML for the current project.
filter_addAttach a video/audio effect to a timeline clip.
filter_listList all active filters on a specific timeline clip.
filter_list_availableDiscover all filters the Kdenlive runtime exposes.
filter_removewrite actionDetach an effect from a clip.
filter_set_paramwrite actionUpdate a single parameter on an active filter.
guide_addPlace a navigation guide marker along the timeline.
guide_getGet single guide by ID.
guide_listReturn all guide markers on the timeline.
guide_removewrite actionDelete a guide marker by its ID.
guide_updatewrite actionUpdate guide properties.
marker_addAdd timeline or clip marker (markers separate from guides).
marker_listList all markers.
marker_removewrite actionRemove marker by ID.
project_get_infoReturn project metadata: FPS, resolution, track layout, bin clip count.
project_get_profileGet the current project's video profile (resolution, FPS, aspect ratio).
project_get_render_profilesAlias for project_list_profiles - get available render presets.
project_list_profilesEnumerate all available video output profiles (hd1080p30, 4k60, sd_pal, etc.).
project_newwrite actionCreate a brand new Kdenlive project session.
project_openLoad an existing .kdenlive-cli.json project into the session.
project_savePersist the current project state to a file.
project_set_profileSet or update the project's video profile.
render_queue_addAdd job to render queue.
render_queue_listList render queue jobs.
render_queue_startStart processing render queue (renders sequentially via melt).
render_queue_statusGet render queue status.
render_queue_stopStop render queue (marks running as stopped).
session_historyList all undo/redo history entries with descriptions.
session_redoReapply the last undone operation.
session_redo_stepRedo N steps (granular).
session_statusInspect session state: project loaded, modified flag, history depth.
session_undoRevert the most recent state change (up to 50 history entries).
session_undo_stepUndo N steps (granular).
timeline_add_clipPlace a bin clip onto a specific track at a given time position.
timeline_add_trackAppend a video or audio track to the timeline.
timeline_get_durationGet total timeline duration in seconds (max end time).
timeline_get_infoGet comprehensive timeline info: tracks+clips, duration, position, zoom, guides, markers, profile.
timeline_get_positionGet current playhead position.
timeline_get_zoomGet timeline zoom level.
timeline_listReturn all timeline tracks with clip counts, IDs, mute/lock status.
timeline_move_clipReposition a clip on the same track to a new time position.
timeline_remove_clipwrite actionDelete a clip from the timeline.
timeline_remove_trackwrite actionDelete a track and all its clips from the timeline.
timeline_seekSeek playhead to position (seconds).
timeline_set_zoomSet timeline zoom level (0.1 .. 10.0).
timeline_split_clipCut a clip into two independent pieces at a precise time offset.
timeline_trim_clipAdjust the in/out trim handles of a timeline clip (not the crop filter).
track_get_infoGet detailed info for a single track (including clips).
track_move_downMove track down one position (swap with next).
track_move_upMove track up one position (swap with previous).
track_set_hiddenHide/show a track (video visibility).
track_set_lockedLock/unlock a track.
track_set_mutedMute/unmute a track (audio).
track_set_nameRename a track.
transition_addwrite actionCreate a blend transition (crossfade, wipe, etc.) between two track layers.
transition_listList all transitions on the timeline.
transition_removewrite actionDelete a transition by its numeric ID.
transition_setModify a parameter on an existing transition.
Public scan report
scanner v0.1.10 · 2026-10-16 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Kdenlive MCP Server compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 88% of 1,336 Media servers
- Tools
- 73
- the typical Media server has 6
- Tools that change things
- 16%
- typical: 3%. Fewer write tools means less an agent can break
- GitHub stars
- 5
- more than 83% of 716 Media servers
- Downloads a week
- 52
- more than 39% of 372 Media servers with a package
What its tools let an agent do: 59 read · 14 change
Install Kdenlive MCP Server in Claude Code, Cursor or VS Code
claude mcp add kdenlive-mcp-server -- uvx kdenlive-mcp-server
What the publisher says
From the Kdenlive MCP Server repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.va1bhav512/kdenlive-mcp-server -->
Kdenlive MCP Server
A Model Context Protocol (MCP) server wrapping cli-anything-kdenlive for LLM-driven video editing workflows via Kdenlive.
Overview
This FastMCP server enables AI models to perform complex video editing tasks on Kdenlive projects through a unified set of 36 tools organized into 8 functional categories. The server uses the Python API of cli-anything-kdenlive directly (not subprocess) to maintain a persistent session state, ensuring modifications are immediately available to subsequent tool calls.
Key Features
- Persistent Session State: Uses CLI's in-memory session API, auto-saves after every mutation
- Gen 5 XML Export: Kdenlive-compatible XML output with proper bin references and version metadata
- Robust Error Handling: All exceptions caught and returned as structured JSON payloads
- Auto-Project Tracking: Globally tracks project path; all tools automatically target the active project
- 36 MCP Tools: Comprehensive coverage of Kdenlive operations
Installation
Prerequisites
# Python 3.10+
# Ensure uv is installed for dependency management
pip install uvInstall Dependencies
cd kdenlive-mcp-server
uv syncUsage
As an MCP Server
The server runs as a FastMCP server compatible with any LLM platform that supports MCP (e.g., Claude Code, Pi, OpenCode).
Command Line
# Run the MCP server
uv run kdenlive-mcp
# Or directly via Python
uv run python3 -m kdenlive_mcp_server.serverPython Integration
from kdenlive_mcp_server.server import (
project_new, bin_import_clip, timeline_add_clip, export_xml
)
# Create project
result = project_new(output_path="my_project.kdenlive-cli.json", profile="hd1080p30")
# Import media
result = bin_import_clip(clip_path="video.mp4", name="Interview", duration=120.0)
# Add to timeline
result = timeline_add_clip(clip_id="clip0", track=0, position=0.0)
# Export XML
result = export_xml(output_path="output.kdenlive")Project Structure
kdenlive-mcp-server/
├── kdenlive_mcp_server/
│ ├── __init__.py # Empty package init
│ └── server.py # FastMCP server with 36 tools (876 lines)
├── main.py # Entry point delegating to server module
├── pyproject.toml # Project configuration and dependencies
├── uv.lock # Dependency lock file
└── README.md # This fileTools
Project (5 tools)
Bin (4 tools)
Timeline (8 tools)
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Kdenlive MCP Server: common questions
- Is Kdenlive MCP Server safe?
- Yes, by our scan: it is graded A (92/100). Read the Kdenlive MCP Server safety report
- How do I install Kdenlive MCP Server?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Kdenlive MCP Server need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Kdenlive MCP Server maintained?
- The last commit was 22 days ago (2026-10-14). The latest release is v0.1.3.
- What can I use instead of Kdenlive MCP Server?
- Servers from other publishers that do the same job: Luw.ai MCP server, Kinocut MCP server and StudioMeyer Video MCP server. Compare all Kdenlive MCP Server alternatives.
- How does Kdenlive MCP Server compare with other Media MCP servers?
- safety score 92/100 (higher than 88% of 1,336 Media servers); tools 73 (the typical Media server has 6); tools that change things 16% (typical: 3%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Kdenlive MCP Server
Same job from other publishers: the closest match first, then the best rated.
Luw.aiAI interior, exterior and landscape design, photoreal rendering, image editing, video and 3D.not reviewedGrowingA
KinocutGuardrailed video editing for AI agents: FFmpeg, captions, effects, Hyperframes, and receipts.not reviewedEstablishedB
StudioMeyer VideoVideo production: recording, editing, effects, captions, TTS, screenshots. 8 tools.not reviewedGrowingB- KattoAI video clipping MCP: long videos and podcasts into scored, captioned 9:16 shorts.5.0(1)GrowingB
- Remove AI WatermarksIdentify and remove AI watermarks and provenance metadata from your own images and video.not reviewedWidely usedA