Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Kdenlive

PYPI · MCP-KDENLIVE

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

Available components

+15 this week 78 Trust /100

Last scanned (21 hours ago)

Scores higher than 73% of PyPI servers

Category Design and Media

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
  • 1 of 28 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to mhbxyz/kdenlive-mcp). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 8 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability60
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 7593 tokens (~205/item across 37 items; 37 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage95
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 83% of tool parameters carry a description.Partial
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 38 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

What we tested

Checks we ran (15)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Checks we could not complete (1)

These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Stability in Stability & Change Management (scores 0 for this)Stability not yet verified: not enough scan history yet (needs a 30-day window).

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 19 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 16 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 15 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 10 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 9 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 8 Nov 26 63

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed pypi/mcp-kdenlive@0.3.0

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem pypi
Reason Verified
Discovered via Registry attestation endpoint
Source repo mhbxyz/kdenlive-mcp
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/mhbxyz/kdenlive-mcp/.github/workflows/release.yml@refs/tags/v0.3.0
Rekor log index 3758559336
Predicate type PyPI publish attestation https://docs.pypi.org/attestations/publish/v1
Subject digest sha256:9f7cb2712eb2aea456b3fdf296e43be9c6c48d86b14bd95787c358072abca817

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend Known build tool hatchling.build

Background: Why install scripts are a supply-chain risk →

Dependencies 28 packages
Packages resolved 28
No linked repository 1
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 37 exposed · ~7,532 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
add_effect ~280

Append a verified effect (list_effects) to a clip, with optional parameters; omitted ones take their defaults. Video effects go on the video part of an audio/video pair. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
clipstringyesClip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
effectstringyesEffect id from list_effects, e.g. 'crop'.
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
overwriteboolean–Allow replacing an existing destination file.
params–––
pathstringyesAbsolute path of a .kdenlive project file on this machine.
revisionstringyessha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

add_marker ~268

Add a guide or a clip marker with a comment, a category and an optional duration in frames (0 = point marker). Without `bin_id` the marker is a timeline **guide** (position in timeline frames); with `bin_id` it is a **clip marker** on that bin clip (position in the clip's source frames, shown on every instance). Kdenlive keeps one marker per position. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
bin_id––Bin clip id for a clip marker; omit for a timeline guide.
categoryinteger––
commentstring––
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
durationinteger––
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
positionintegeryes–
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

add_media_to_bin ~188

Add audio or video files to a project's bin (not to the timeline) and write the result to `destination`. Files already in the bin are reported as 'existing' with their clip id instead of being duplicated. Clip data comes from MLT, as in Kdenlive. Same safety rules as save_project_copy.

NameTypeReqDescription
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
media_pathsarrayyesAbsolute paths of media files.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

add_mix ~281

Crossfade a clip into the next clip on its track (they must touch), like Kdenlive's Mix Clips: both clips extend into their source handles around the cut, and grouped audio gets the matching audio crossfade. `duration` in frames (default 1 second). The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
clipstringyesClip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
duration–––
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
revisionstringyessha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

add_title ~389

Create a text title (an editable Kdenlive title clip, not an image) and place it on a video track, usually one above the footage (add_track). Unicode and several lines (\n) are kept. Position: `align` x `vertical` presets inside 5 % margins, or the box's top-left `x`, `y` in pixels. The font must be installed (checked with fontconfig); `font` defaults to an installed sans font. The result gives the bin id, so insert_clip can place the same title again. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
alignstring––
colorstring–#RRGGBB or #RRGGBBAA.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
duration–––
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
font–––
font_size–––
italicboolean––
outlineinteger–Outline width, pixels.
outline_colorstring–#RRGGBB or #RRGGBBAA.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
sequence––Sequence uuid or name; default: active sequence.
startintegeryesTimeline frame.
textstringyesTitle text; \n starts a new line.
trackstringyesVideo track label, e.g. V2.
verticalstring––
x–––
y–––
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

add_track ~215

Add an empty, optionally named audio or video track to a sequence and write the result to `destination`. Video tracks are added on top of the existing video tracks; audio tracks below the existing audio tracks (Kdenlive's track order). Existing clips, groups, compositions and mixes are preserved. Same safety rules as save_project_copy.

NameTypeReqDescription
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
kindstringyes'audio' or 'video'.
name––Track name shown in Kdenlive.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

cancel_render_job ~72

Request cancellation of a queued or running render job. The returned job has cancel_requested=true; its state becomes 'cancelled' once Kdenlive and its child processes have exited and the partial output was removed. Cancelling a finished job changes nothing.

NameTypeReqDescription
job_idstringyesId returned by start_render.
NameTypeReqDescription
cancel_requestedboolean––
created_atstringyes–
elapsed_seconds–––
finished_at–––
job_idstringyes–
outputstringyes–
presetstringyes–
progress–––
progress_note–––
projectstringyes–
queue_position––1 = next to start.
result––Full result (validation, log tail) once the job has ended.
started_at–––
state–yes–
timeout_secondsnumberyes–

No examples provided.

create_project ~229

Create a new Kdenlive project file containing one media clip placed at the start of the timeline (video on V1, audio on A1, grouped). Like a new Kdenlive project, it has two video tracks (V1, V2) and two audio tracks (A1, A2): V2 is free for overlays and titles before any add_track. The project is modeled on Kdenlive 26.08 files and stays editable in Kdenlive. `profile` is an MLT profile name (see list_profiles) or 'auto' to use the standard profile matching the media. Refuses to replace an existing file unless overwrite=true; writes atomically and never modifies the media. Media inside the project's directory is stored with a relative path.

NameTypeReqDescription
destinationstringyesAbsolute path of the new .kdenlive file.
media_pathstringyesAbsolute path of an audio or video file.
overwriteboolean–Replace an existing project file.
profilestring–MLT profile name, or 'auto' to match the media.
NameTypeReqDescription
clip_duration_framesintegeryes–
frame_ratestringyes–
kdenlive_formatstringyes–
mediastringyes–
media_referencestringyesPath stored in the project (relative when possible).
notesarrayyes–
profilestringyes–
projectstringyes–
project_sha256stringyes–
tracksarrayyesTracks that received the clip, e.g. ['V1', 'A1'].
warningsarrayyes–

No examples provided.

diagnose_environment ~120

Report whether Kdenlive, MLT (melt), ffprobe and ffmpeg are installed and usable, with their paths, versions and actionable hints. Read-only: modifies nothing. Locations can be overridden with KDENLIVE_MCP_KDENLIVE, KDENLIVE_MCP_MELT, KDENLIVE_MCP_FFPROBE and KDENLIVE_MCP_FFMPEG in the server environment. `filesystem` lists the folders the tools may read and write (KDENLIVE_MCP_ALLOWED_ROOTS; by default the user's videos directory).

Input schema present but exposes no named parameters.

NameTypeReqDescription
filesystem–yes–
notesarray–Limitations of this report: what was not verified.
platform–yes–
readybooleanyesTrue when every required program is available.
server_versionstringyes–
toolsarrayyes–

No examples provided.

get_render_job ~64

State of a render job: queued (with queue position), running (elapsed time; progress only when Kdenlive reports it), or ended with the full result (exit status, output validation, log tail).

NameTypeReqDescription
job_idstringyesId returned by start_render.
NameTypeReqDescription
cancel_requestedboolean––
created_atstringyes–
elapsed_seconds–––
finished_at–––
job_idstringyes–
outputstringyes–
presetstringyes–
progress–––
progress_note–––
projectstringyes–
queue_position––1 = next to start.
result––Full result (validation, log tail) once the job has ended.
started_at–––
state–yes–
timeout_secondsnumberyes–

No examples provided.

get_timeline ~122

Return the tracks, clips, mixes, compositions and guides of one sequence of a Kdenlive project, read-only. Positions are integer frames at the project frame rate; timeline ranges are [start, end) and source in/out are inclusive (see the 'conventions' field). Large timelines are truncated to max_clips.

NameTypeReqDescription
max_clipsinteger–Maximum clips returned.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
sequence––Sequence uuid or name; defaults to the active sequence.
NameTypeReqDescription
compositionsarrayyes–
conventionsstringyes–
duration_framesintegeryes–
duration_timecodestringyes–
file–yes–
frame_rate–yes–
guidesarrayyes–
notesarrayyes–
returned_clipsintegeryes–
sequence_name–yes–
sequence_uuidstringyes–
total_clipsintegeryes–
tracksarrayyes–
truncatedbooleanyesTrue if clips were omitted because of max_clips.
warningsarrayyes–

No examples provided.

import_subtitles ~321

Import a SubRip (.srt) or WebVTT (.vtt) file, UTF-8 or UTF-16 with a byte order mark, as the main sequence's subtitles, in Kdenlive's own format: an ASS file named after the saved project (`<destination>.ass`) with Kdenlive's default style. Times are rounded to frames; overlapping subtitles go to separate layers; <i>, <b>, <u> become ASS styling, other styling is dropped (warnings). Existing subtitles are refused ([subtitles_exist]) unless replace=true; written to a new destination their file is untouched, replaced in place it is backed up first. `offset` shifts every subtitle by that many frames. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
offsetinteger–Frames added to every subtitle.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
replaceboolean––
sequence––Sequence uuid or name; default: active sequence.
subtitle_filestringyesPath of the .srt or .vtt file.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

insert_clip ~297

Place a bin clip (bin_id from list_project_media / get_timeline) on a track at frame `start`, optionally a source sub-range [source_in, source_out] (inclusive). A clip with audio and video put on a video track also gets its audio on `audio_track` (default A1; null for video only), grouped like Kdenlive. Positions are frames at the project rate; nothing ripples and nothing is overwritten (overlaps fail). A clip grouped with its audio/video counterpart is edited together with it. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
audio_track–––
bin_idstringyes–
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
sequence––Sequence uuid or name; default: active sequence.
source_ininteger––
source_out–––
startintegeryes–
trackstringyesTrack label, e.g. V1.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

inspect_project ~103

Summarize a Kdenlive project file without modifying it: Kdenlive and document versions, profile (resolution, rational frame rate), bin clip count and each timeline sequence with its duration and track counts. Includes the file's sha256 so later calls can detect changes. Reads the file on disk only: unsaved changes in a running Kdenlive are not visible.

NameTypeReqDescription
pathstringyesAbsolute path of a .kdenlive project file on this machine.
NameTypeReqDescription
bin_clip_countintegeryes–
document_version–yes–
file–yes–
format_generationintegeryes5 = Kdenlive ≥ 23.04 (multiple sequences).
kdenlive_version–yesKdenlive version that last saved the file.
mlt_version–yes–
notesarrayyes–
profile–yes–
sequencesarrayyes–
warningsarrayyes–

No examples provided.

list_effects ~68

List the effects this server can apply (a subset verified against Kdenlive's own format): identifier, target (video/audio), parameters with units, ranges and defaults, and whether the installed MLT provides them. Crossfades between adjacent clips use add_mix / remove_mix. Read-only.

Input schema present but exposes no named parameters.

NameTypeReqDescription
effectsarrayyes–
notesarrayyes–
transitionsarrayyesSame-track transitions.

No examples provided.

list_markers ~88

List the timeline guides of a sequence, the clip markers of every bin clip, and the marker categories (index, name, color). Positions are frames: timeline frames for guides, source frames for clip markers. Read-only.

NameTypeReqDescription
pathstringyesAbsolute path of a .kdenlive project file on this machine.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
categoriesarrayyes–
clip_markersarrayyes–
guidesarrayyes–

No examples provided.

list_profiles ~29

List the MLT video profiles available for new projects (name, resolution, rational frame rate, progressive).

Input schema present but exposes no named parameters.

NameTypeReqDescription
profilesarrayyes–

No examples provided.

list_project_media ~148

List the media referenced by a Kdenlive project's bin and diagnose missing or unreadable files, plus files used by effects and transitions (LUTs, luma wipes, subtitles). References are resolved exactly like Kdenlive does (project root, moved projects, proxies). Read-only; URLs are reported but never fetched. With probe=true, ffprobe metadata (streams, codecs, sizes, frame rates, rotation) is added for up to 50 available files.

NameTypeReqDescription
max_itemsinteger–Maximum bin items returned.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
probeboolean–Run ffprobe on available files.
NameTypeReqDescription
asset_filesarrayyesFiles used by effects and transitions (checked like Kdenlive does).
countsobjectyes–
itemsarrayyes–
missingarrayyesResolved paths (or references) of missing media.
notesarrayyes–
probedintegeryes–
projectstringyes–
root–yes–
total_itemsintegeryes–
truncatedbooleanyes–

No examples provided.

list_render_jobs ~21

List render jobs of this server session, most recent first.

Input schema present but exposes no named parameters.

NameTypeReqDescription
jobsarrayyes–
max_concurrentintegeryes–
notesarrayyes–

No examples provided.

list_render_presets ~41

List the render presets of the installed Kdenlive (system and user custom presets), with group and file extension. Use a returned name with render_project.

Input schema present but exposes no named parameters.

NameTypeReqDescription
notesarrayyes–
presetsarrayyes–
sourcesarrayyes–

No examples provided.

list_subtitles ~92

Read a sequence's subtitles (Kdenlive's subtitle track, an ASS file next to the project): file and status, styles, and events with start/end frames, layer and text. Read-only.

NameTypeReqDescription
max_eventsinteger––
pathstringyesAbsolute path of a .kdenlive project file on this machine.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
sequence_uuid–yes–
tracksarrayyes–
truncatedbooleanyesTrue when events beyond max_events were left out.

No examples provided.

move_clip ~283

Move a clip to frame `start`, optionally to another track of the same kind. Positions are frames at the project rate; nothing ripples and nothing is overwritten (overlaps fail). A clip grouped with its audio/video counterpart is edited together with it. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
clipstringyesClip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
revisionstringyessha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since.
sequence––Sequence uuid or name; default: active sequence.
startintegeryes–
track–––
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

probe_media ~77

Check one local media file (absolute path) and return ffprobe metadata: duration, streams, codecs, dimensions, rational frame rate, sample rate, channels, rotation. Read-only; URLs are refused. Probing reads headers and does not prove that every frame decodes.

NameTypeReqDescription
pathstringyesAbsolute path of a local media file.
NameTypeReqDescription
detail–yes–
pathstringyes–
probe–yes–
status–yes–
symlink_target–yes–

No examples provided.

relink_media ~256

Point bin clips at new media files, for example after moving a media folder. `mapping` maps a bin_id, a stored reference or a resolved path (from list_project_media) to the new absolute path. Every copy of the clip (bin and timeline instances) is updated; timing, ids and effects are kept. The new file is read by MLT first: fewer frames than the timeline uses, or a missing video/audio stream it uses, is refused ([media_mismatch]); other differences are warnings. Clips using a proxy are refused. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
mappingobjectyes{bin_id | old reference | old resolved path: new absolute path}
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

remove_clip ~276

Remove a clip from the timeline, leaving a gap (neighbours do not move; the bin clip stays). Positions are frames at the project rate; nothing ripples and nothing is overwritten (overlaps fail). A clip grouped with its audio/video counterpart is edited together with it. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
clipstringyesClip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
revisionstringyessha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

remove_effect ~268

Remove the clip's effect at `index` (any effect). Video effects go on the video part of an audio/video pair. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
clipstringyesClip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
indexintegeryesPosition of the effect in the clip's `effects` (get_timeline).
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
revisionstringyessha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

remove_marker ~229

Remove the marker at `position`. Without `bin_id` the marker is a timeline **guide** (position in timeline frames); with `bin_id` it is a **clip marker** on that bin clip (position in the clip's source frames, shown on every instance). Kdenlive keeps one marker per position. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
bin_id––Bin clip id for a clip marker; omit for a timeline guide.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
positionintegeryes–
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

remove_mix ~240

Remove the crossfade at the end of a clip; both clips go back to the original cut. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
clipstringyesClip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
revisionstringyessha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

render_project ~294

Render a Kdenlive project to a new local file with an installed Kdenlive preset (kdenlive --render, or MLT's melt: see `engine`), then validate the output with ffprobe. Blocks until the render ends or `timeout_seconds` elapses. Never modifies the project or its media. Refuses an existing output unless overwrite=true (the old file is replaced only after a successful, validated render), unknown presets, and projects with missing media unless allow_missing_media=true. Renders the file on disk, not unsaved changes in a running Kdenlive.

NameTypeReqDescription
allow_missing_mediaboolean–Render even if media files are missing.
enginestring–'kdenlive' runs kdenlive --render (Kdenlive 24.02+); 'melt' renders with MLT directly using the preset's arguments (not Kdenlive's own render path); 'auto' uses Kdenlive when it can, and melt for old…
outputstringyesAbsolute path of the file to create.
overwriteboolean–Replace an existing output file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
presetstring–Kdenlive preset name (see list_render_presets).
timeout_secondsnumber–Stop the render after this.
NameTypeReqDescription
elapsed_seconds–––
enginestring–'kdenlive' (kdenlive --render) or 'melt' (MLT directly, see notes).
error–––
exit_code–––
log_tailarray––
notesarray––
outputstringyes–
presetstringyes–
process_completedbooleanyesThe render process exited with status 0.
projectstringyes–
project_sha256stringyes–
sequence–yes–
state–yes–
validation––ffprobe check of the produced file (separate from completion).
warningsarray––

No examples provided.

save_project_copy ~177

Write a verified copy of a Kdenlive project to another .kdenlive file, preserving all project data (unknown metadata included). Relative media paths are rewritten so they still work from the destination folder. Refuses to overwrite an existing file unless overwrite=true (a timestamped backup is kept), refuses to write over the source unless overwrite=true and expected_sha256 (from inspect_project) match, and refuses if the source changed since it was read or the destination is open in Kdenlive.

NameTypeReqDescription
destinationstringyesAbsolute path of the .kdenlive to write.
expected_sha256––Required to write over the source: its sha256 as last read.
overwriteboolean–Allow replacing an existing file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
NameTypeReqDescription
backup–yesCopy of the replaced file, when one was replaced.
changesarrayyesHuman-readable list of modifications applied.
destinationstringyes–
notesarrayyes–
rebased_pathsarrayyesReferences rewritten for the new location.
sha256stringyes–
side_filesarray–Other files written next to the project (e.g. subtitles), with it.
size_bytesintegeryes–
sourcestringyes–
source_sha256stringyesRevision of the source that was edited.
warningsarrayyes–
writtenboolean–False when nothing changed and the destination already had this content: no write and no backup.

No examples provided.

set_clip_fades ~306

Set the audio fade-in and/or fade-out of a clip, in frames (omit to keep, 0 to remove), with Kdenlive's Fade in / Fade out effects. Both must fit in the clip. For an audio/video pair, the audio clip is changed. Fades stay at the clip's edges when it is later trimmed or split. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
clipstringyesClip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
fade_in–––
fade_out–––
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
revisionstringyessha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

set_clip_volume ~288

Set a constant audio level in dB (-100 to +20; 0 = unchanged level) on a clip's audio, with Kdenlive's Volume effect. For an audio/video pair, the audio clip is changed. An existing constant level is replaced; an animated one is refused. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
clipstringyesClip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
level_dbnumberyes–
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
revisionstringyessha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

split_clip ~278

Cut a clip at timeline frame `at` into two adjacent clips (razor). Positions are frames at the project rate; nothing ripples and nothing is overwritten (overlaps fail). A clip grouped with its audio/video counterpart is edited together with it. The result is written to `destination` with the save_project_copy rules.

NameTypeReqDescription
atintegeryes–
clipstringyesClip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit.
destinationstringyesAbsolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules).
expected_sha256––Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted.
overwriteboolean–Allow replacing an existing destination file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
revisionstringyessha256 of the project file (file.sha256 from get_timeline) that the clip ref comes from; the edit is refused if the file changed since.
sequence––Sequence uuid or name; default: active sequence.
NameTypeReqDescription
audio–––
effects–––
markers–––
media–––
relink–––
saved–yes–
subtitles–––
timeline–––
title–––
track–––

No examples provided.

start_render ~249

Start rendering a Kdenlive project in the background and return a job id immediately. Same checks and guarantees as render_project (preset, output, missing media, atomic publication after validation). Poll get_render_job for the state (queued, running, succeeded, failed, cancelled) and cancel with cancel_render_job. Jobs live in memory and are stopped when the server exits.

NameTypeReqDescription
allow_missing_mediaboolean–Render even if media files are missing.
enginestring–'kdenlive' runs kdenlive --render (Kdenlive 24.02+); 'melt' renders with MLT directly using the preset's arguments (not Kdenlive's own render path); 'auto' uses Kdenlive when it can, and melt for old…
outputstringyesAbsolute path of the file to create.
overwriteboolean–Replace an existing output file.
pathstringyesAbsolute path of a .kdenlive project file on this machine.
presetstring–Kdenlive preset name (see list_render_presets).
timeout_secondsnumber–Stop the render after this.
NameTypeReqDescription
cancel_requestedboolean––
created_atstringyes–
elapsed_seconds–––
finished_at–––
job_idstringyes–
outputstringyes–
presetstringyes–
progress–––
progress_note–––
projectstringyes–
queue_position––1 = next to start.
result––Full result (validation, log tail) once the job has ended.
started_at–––
state–yes–
timeout_secondsnumberyes–

No examples provided.

Install

How do I install the Kdenlive MCP server?

Kdenlive runs locally as a PyPI package, launched with uvx mcp-kdenlive. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · mcp-kdenlive

# add to Claude Code
claude mcp add mhbxyz-kdenlive-mcp -- uvx mcp-kdenlive
Common questions

What is the Kdenlive MCP server?

Kdenlive is an MCP server listed in the public MCP registry as io.github.mhbxyz/kdenlive-mcp. Inspect, edit and render Kdenlive video projects locally on Linux. This page covers its PyPI package (mcp-kdenlive).

Is the Kdenlive MCP server safe to use?

Kdenlive scores 78 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the Kdenlive MCP server expose?

Kdenlive exposes 37 tools: diagnose_environment, inspect_project, get_timeline, list_project_media, probe_media, and 32 more. Their descriptions and schemas cost roughly 7,532 tokens of context every time the server is loaded.

Is the Kdenlive MCP server still maintained?

Kdenlive is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the Kdenlive MCP server under?

Kdenlive declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the Kdenlive MCP server?

VerifyMCP ran 15 checks on Kdenlive, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about Kdenlive: Stability. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.