README

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

mcp-kdenlive

README

mcp-kdenlive

Quick start

Requirements

Tools

Composite (use these first)

Atomic

Related repos

Recommended Servers