Kdenlive
PYPI · MCP-KDENLIVE
Inspect, edit and render Kdenlive video projects locally on Linux.
Available components
Last scanned (21 hours ago)
Scores higher than 73% of PyPI servers
Category Design and Media
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.
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 →
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.
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 →
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 →
add_effect 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.
| Name | Type | Req | Description |
|---|---|---|---|
| clip | string | yes | Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit. |
| destination | string | yes | Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules). |
| effect | string | yes | Effect 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. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| params | – | – | – |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| revision | string | yes | sha256 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
add_marker Add guide or clip 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.
| Name | Type | Req | Description |
|---|---|---|---|
| bin_id | – | – | Bin clip id for a clip marker; omit for a timeline guide. |
| category | integer | – | – |
| comment | string | – | – |
| destination | string | yes | Absolute path of the .kdenlive file to write (the source by default is never modified; see save_project_copy for the overwrite rules). |
| duration | integer | – | – |
| expected_sha256 | – | – | Required to write over the source: its sha256 as last read. Tools that take `revision` use it when this is omitted. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| position | integer | yes | – |
| sequence | – | – | Sequence uuid or name; default: active sequence. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
add_media_to_bin 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.
| Name | Type | Req | Description |
|---|---|---|---|
| destination | string | yes | Absolute 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_paths | array | yes | Absolute paths of media files. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
add_mix Add crossfade ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| clip | string | yes | Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit. |
| destination | string | yes | Absolute 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. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| revision | string | yes | sha256 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
add_title 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.
| Name | Type | Req | Description |
|---|---|---|---|
| align | string | – | – |
| color | string | – | #RRGGBB or #RRGGBBAA. |
| destination | string | yes | Absolute 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 | – | – | – |
| italic | boolean | – | – |
| outline | integer | – | Outline width, pixels. |
| outline_color | string | – | #RRGGBB or #RRGGBBAA. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| sequence | – | – | Sequence uuid or name; default: active sequence. |
| start | integer | yes | Timeline frame. |
| text | string | yes | Title text; \n starts a new line. |
| track | string | yes | Video track label, e.g. V2. |
| vertical | string | – | – |
| x | – | – | – |
| y | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
add_track 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.
| Name | Type | Req | Description |
|---|---|---|---|
| destination | string | yes | Absolute 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. |
| kind | string | yes | 'audio' or 'video'. |
| name | – | – | Track name shown in Kdenlive. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| sequence | – | – | Sequence uuid or name; default: active sequence. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
cancel_render_job 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.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Id returned by start_render. |
| Name | Type | Req | Description |
|---|---|---|---|
| cancel_requested | boolean | – | – |
| created_at | string | yes | – |
| elapsed_seconds | – | – | – |
| finished_at | – | – | – |
| job_id | string | yes | – |
| output | string | yes | – |
| preset | string | yes | – |
| progress | – | – | – |
| progress_note | – | – | – |
| project | string | yes | – |
| queue_position | – | – | 1 = next to start. |
| result | – | – | Full result (validation, log tail) once the job has ended. |
| started_at | – | – | – |
| state | – | yes | – |
| timeout_seconds | number | yes | – |
No examples provided.
create_project 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.
| Name | Type | Req | Description |
|---|---|---|---|
| destination | string | yes | Absolute path of the new .kdenlive file. |
| media_path | string | yes | Absolute path of an audio or video file. |
| overwrite | boolean | – | Replace an existing project file. |
| profile | string | – | MLT profile name, or 'auto' to match the media. |
| Name | Type | Req | Description |
|---|---|---|---|
| clip_duration_frames | integer | yes | – |
| frame_rate | string | yes | – |
| kdenlive_format | string | yes | – |
| media | string | yes | – |
| media_reference | string | yes | Path stored in the project (relative when possible). |
| notes | array | yes | – |
| profile | string | yes | – |
| project | string | yes | – |
| project_sha256 | string | yes | – |
| tracks | array | yes | Tracks that received the clip, e.g. ['V1', 'A1']. |
| warnings | array | yes | – |
No examples provided.
diagnose_environment 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.
| Name | Type | Req | Description |
|---|---|---|---|
| filesystem | – | yes | – |
| notes | array | – | Limitations of this report: what was not verified. |
| platform | – | yes | – |
| ready | boolean | yes | True when every required program is available. |
| server_version | string | yes | – |
| tools | array | yes | – |
No examples provided.
get_render_job 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).
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Id returned by start_render. |
| Name | Type | Req | Description |
|---|---|---|---|
| cancel_requested | boolean | – | – |
| created_at | string | yes | – |
| elapsed_seconds | – | – | – |
| finished_at | – | – | – |
| job_id | string | yes | – |
| output | string | yes | – |
| preset | string | yes | – |
| progress | – | – | – |
| progress_note | – | – | – |
| project | string | yes | – |
| queue_position | – | – | 1 = next to start. |
| result | – | – | Full result (validation, log tail) once the job has ended. |
| started_at | – | – | – |
| state | – | yes | – |
| timeout_seconds | number | yes | – |
No examples provided.
get_timeline 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.
| Name | Type | Req | Description |
|---|---|---|---|
| max_clips | integer | – | Maximum clips returned. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| sequence | – | – | Sequence uuid or name; defaults to the active sequence. |
| Name | Type | Req | Description |
|---|---|---|---|
| compositions | array | yes | – |
| conventions | string | yes | – |
| duration_frames | integer | yes | – |
| duration_timecode | string | yes | – |
| file | – | yes | – |
| frame_rate | – | yes | – |
| guides | array | yes | – |
| notes | array | yes | – |
| returned_clips | integer | yes | – |
| sequence_name | – | yes | – |
| sequence_uuid | string | yes | – |
| total_clips | integer | yes | – |
| tracks | array | yes | – |
| truncated | boolean | yes | True if clips were omitted because of max_clips. |
| warnings | array | yes | – |
No examples provided.
import_subtitles 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.
| Name | Type | Req | Description |
|---|---|---|---|
| destination | string | yes | Absolute 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. |
| offset | integer | – | Frames added to every subtitle. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| replace | boolean | – | – |
| sequence | – | – | Sequence uuid or name; default: active sequence. |
| subtitle_file | string | yes | Path of the .srt or .vtt file. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
insert_clip 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.
| Name | Type | Req | Description |
|---|---|---|---|
| audio_track | – | – | – |
| bin_id | string | yes | – |
| destination | string | yes | Absolute 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. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| sequence | – | – | Sequence uuid or name; default: active sequence. |
| source_in | integer | – | – |
| source_out | – | – | – |
| start | integer | yes | – |
| track | string | yes | Track label, e.g. V1. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
inspect_project 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.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| Name | Type | Req | Description |
|---|---|---|---|
| bin_clip_count | integer | yes | – |
| document_version | – | yes | – |
| file | – | yes | – |
| format_generation | integer | yes | 5 = Kdenlive ≥ 23.04 (multiple sequences). |
| kdenlive_version | – | yes | Kdenlive version that last saved the file. |
| mlt_version | – | yes | – |
| notes | array | yes | – |
| profile | – | yes | – |
| sequences | array | yes | – |
| warnings | array | yes | – |
No examples provided.
list_effects 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.
| Name | Type | Req | Description |
|---|---|---|---|
| effects | array | yes | – |
| notes | array | yes | – |
| transitions | array | yes | Same-track transitions. |
No examples provided.
list_markers List guides and clip 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.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| sequence | – | – | Sequence uuid or name; default: active sequence. |
| Name | Type | Req | Description |
|---|---|---|---|
| categories | array | yes | – |
| clip_markers | array | yes | – |
| guides | array | yes | – |
No examples provided.
list_profiles List project 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.
| Name | Type | Req | Description |
|---|---|---|---|
| profiles | array | yes | – |
No examples provided.
list_project_media 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.
| Name | Type | Req | Description |
|---|---|---|---|
| max_items | integer | – | Maximum bin items returned. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| probe | boolean | – | Run ffprobe on available files. |
| Name | Type | Req | Description |
|---|---|---|---|
| asset_files | array | yes | Files used by effects and transitions (checked like Kdenlive does). |
| counts | object | yes | – |
| items | array | yes | – |
| missing | array | yes | Resolved paths (or references) of missing media. |
| notes | array | yes | – |
| probed | integer | yes | – |
| project | string | yes | – |
| root | – | yes | – |
| total_items | integer | yes | – |
| truncated | boolean | yes | – |
No examples provided.
list_render_jobs List render jobs ~21
List render jobs of this server session, most recent first.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| jobs | array | yes | – |
| max_concurrent | integer | yes | – |
| notes | array | yes | – |
No examples provided.
list_render_presets 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.
| Name | Type | Req | Description |
|---|---|---|---|
| notes | array | yes | – |
| presets | array | yes | – |
| sources | array | yes | – |
No examples provided.
list_subtitles 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.
| Name | Type | Req | Description |
|---|---|---|---|
| max_events | integer | – | – |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| sequence | – | – | Sequence uuid or name; default: active sequence. |
| Name | Type | Req | Description |
|---|---|---|---|
| sequence_uuid | – | yes | – |
| tracks | array | yes | – |
| truncated | boolean | yes | True when events beyond max_events were left out. |
No examples provided.
move_clip 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.
| Name | Type | Req | Description |
|---|---|---|---|
| clip | string | yes | Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit. |
| destination | string | yes | Absolute 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. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| revision | string | yes | sha256 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. |
| start | integer | yes | – |
| track | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
probe_media Probe media file ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Absolute path of a local media file. |
| Name | Type | Req | Description |
|---|---|---|---|
| detail | – | yes | – |
| path | string | yes | – |
| probe | – | yes | – |
| status | – | yes | – |
| symlink_target | – | yes | – |
No examples provided.
relink_media 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.
| Name | Type | Req | Description |
|---|---|---|---|
| destination | string | yes | Absolute 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. |
| mapping | object | yes | {bin_id | old reference | old resolved path: new absolute path} |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
remove_clip 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.
| Name | Type | Req | Description |
|---|---|---|---|
| clip | string | yes | Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit. |
| destination | string | yes | Absolute 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. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| revision | string | yes | sha256 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
remove_effect 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.
| Name | Type | Req | Description |
|---|---|---|---|
| clip | string | yes | Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit. |
| destination | string | yes | Absolute 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. |
| index | integer | yes | Position of the effect in the clip's `effects` (get_timeline). |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| revision | string | yes | sha256 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
remove_marker Remove guide or clip 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.
| Name | Type | Req | Description |
|---|---|---|---|
| bin_id | – | – | Bin clip id for a clip marker; omit for a timeline guide. |
| destination | string | yes | Absolute 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. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| position | integer | yes | – |
| sequence | – | – | Sequence uuid or name; default: active sequence. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
remove_mix Remove crossfade ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| clip | string | yes | Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit. |
| destination | string | yes | Absolute 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. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| revision | string | yes | sha256 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
render_project 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.
| Name | Type | Req | Description |
|---|---|---|---|
| allow_missing_media | boolean | – | Render even if media files are missing. |
| engine | string | – | '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… |
| output | string | yes | Absolute path of the file to create. |
| overwrite | boolean | – | Replace an existing output file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| preset | string | – | Kdenlive preset name (see list_render_presets). |
| timeout_seconds | number | – | Stop the render after this. |
| Name | Type | Req | Description |
|---|---|---|---|
| elapsed_seconds | – | – | – |
| engine | string | – | 'kdenlive' (kdenlive --render) or 'melt' (MLT directly, see notes). |
| error | – | – | – |
| exit_code | – | – | – |
| log_tail | array | – | – |
| notes | array | – | – |
| output | string | yes | – |
| preset | string | yes | – |
| process_completed | boolean | yes | The render process exited with status 0. |
| project | string | yes | – |
| project_sha256 | string | yes | – |
| sequence | – | yes | – |
| state | – | yes | – |
| validation | – | – | ffprobe check of the produced file (separate from completion). |
| warnings | array | – | – |
No examples provided.
save_project_copy 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.
| Name | Type | Req | Description |
|---|---|---|---|
| destination | string | yes | Absolute path of the .kdenlive to write. |
| expected_sha256 | – | – | Required to write over the source: its sha256 as last read. |
| overwrite | boolean | – | Allow replacing an existing file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| Name | Type | Req | Description |
|---|---|---|---|
| backup | – | yes | Copy of the replaced file, when one was replaced. |
| changes | array | yes | Human-readable list of modifications applied. |
| destination | string | yes | – |
| notes | array | yes | – |
| rebased_paths | array | yes | References rewritten for the new location. |
| sha256 | string | yes | – |
| side_files | array | – | Other files written next to the project (e.g. subtitles), with it. |
| size_bytes | integer | yes | – |
| source | string | yes | – |
| source_sha256 | string | yes | Revision of the source that was edited. |
| warnings | array | yes | – |
| written | boolean | – | False when nothing changed and the destination already had this content: no write and no backup. |
No examples provided.
set_clip_fades Set clip audio 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.
| Name | Type | Req | Description |
|---|---|---|---|
| clip | string | yes | Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit. |
| destination | string | yes | Absolute 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 | – | – | – |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| revision | string | yes | sha256 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
set_clip_volume 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.
| Name | Type | Req | Description |
|---|---|---|---|
| clip | string | yes | Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit. |
| destination | string | yes | Absolute 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_db | number | yes | – |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| revision | string | yes | sha256 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
split_clip 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.
| Name | Type | Req | Description |
|---|---|---|---|
| at | integer | yes | – |
| clip | string | yes | Clip ref from get_timeline, '<track>@<start>' (e.g. 'V1@90'). It changes when the clip moves: read the timeline again after an edit. |
| destination | string | yes | Absolute 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. |
| overwrite | boolean | – | Allow replacing an existing destination file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| revision | string | yes | sha256 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| audio | – | – | – |
| effects | – | – | – |
| markers | – | – | – |
| media | – | – | – |
| relink | – | – | – |
| saved | – | yes | – |
| subtitles | – | – | – |
| timeline | – | – | – |
| title | – | – | – |
| track | – | – | – |
No examples provided.
start_render Start render job ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| allow_missing_media | boolean | – | Render even if media files are missing. |
| engine | string | – | '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… |
| output | string | yes | Absolute path of the file to create. |
| overwrite | boolean | – | Replace an existing output file. |
| path | string | yes | Absolute path of a .kdenlive project file on this machine. |
| preset | string | – | Kdenlive preset name (see list_render_presets). |
| timeout_seconds | number | – | Stop the render after this. |
| Name | Type | Req | Description |
|---|---|---|---|
| cancel_requested | boolean | – | – |
| created_at | string | yes | – |
| elapsed_seconds | – | – | – |
| finished_at | – | – | – |
| job_id | string | yes | – |
| output | string | yes | – |
| preset | string | yes | – |
| progress | – | – | – |
| progress_note | – | – | – |
| project | string | yes | – |
| queue_position | – | – | 1 = next to start. |
| result | – | – | Full result (validation, log tail) once the job has ended. |
| started_at | – | – | – |
| state | – | yes | – |
| timeout_seconds | number | yes | – |
No examples provided.
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
claude mcp add mhbxyz-kdenlive-mcp -- uvx mcp-kdenlive
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.