mcp-kdenlive

MCP server for Kdenlive — wraps kdenlive-api for Claude Code and other LLM agents.

Gives an AI agent full NLE control over a running Kdenlive instance via D-Bus: import media, build timelines, add transitions, markers, effects, and render.

Quick start

Add to your .mcp.json:

{
  "mcpServers": {
    "kdenlive": {
      "command": "python",
      "args": ["-m", "mcp_kdenlive"]
    }
  }
}

Requirements

• Python 3.10+
• kdenlive-api
• MCP SDK (mcp>=1.0.0)
• Running patched Kdenlive with D-Bus scripting API

pip install -r requirements.txt

Tools

Composite (use these first)

Tool	Description
build_timeline	Full assembly from scene clips (import + sequence + transitions + audio + markers)
replace_scene	Swap one scene clip by number, keep position and transitions
get_timeline_summary	Text table of all clips on timeline
add_transitions_batch	Batch cross-dissolves between all clips on a track
render_video	Export timeline to video file

Atomic

Domain	Tools
Project	get_project_info, save_project, load_project
Media	get_media_pool, import_media, import_media_glob, create_bin_folder
Timeline	get_track_list, get_clip_info, insert_clip, append_clips, move_clip, delete_clip, add_track, trim_clip
Transitions	add_transition, remove_transition
Markers	get_markers, add_marker, delete_marker, delete_markers_by_color
Replace	replace_clip
Checkpoints	checkpoint_save, checkpoint_restore

Related repos

• kdenlive-api — DaVinci Resolve-compatible Python API
• D-Ogi/kdenlive — Kdenlive fork with D-Bus scripting API