MCP.Market

Kdenlive MCP Server

by Va1bhav512·io.github.Va1bhav512/kdenlive-mcp-server·v0.1.3·5 stars

Kdenlive video editing MCP - 36 tools for project, timeline, filters and melt rendering

A92/100grade A
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

5 stars52 downloads/wk

Reviews

Write one

Nobody has reviewed Kdenlive MCP Server yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Kdenlive MCP Server tools (73, 12 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • bin_create_folderwrite action

    Create folder in project bin.

  • bin_get_clip_details

    Get detailed properties of a bin clip (length, aspect ratio, media info).

  • bin_import_clip

    Ingest a media file into the project bin for later timeline use.

  • bin_list_clips

    List every asset in the project bin with ID, name, type, and duration.

  • bin_move_clip

    Move clip to folder (or root if folder None).

  • bin_remove_clipwrite action

    Delete a clip from the media bin by its ID.

  • bin_rename

    Rename bin clip.

  • clip_add_note

    Add / update note for bin clip.

  • clip_get_properties

    Get timeline clip properties: in/out, duration, speed, opacity, reverse.

  • clip_reverse

    Reverse playback direction of a timeline clip (toggles).

  • clip_set_color

    Set color label for bin clip (hex or named).

  • clip_set_opacity

    Set opacity of a timeline clip (0.0 transparent .. 1.0 opaque).

  • clip_set_speed

    Set playback speed of a timeline clip (1.0=normal, 2.0=2x, 0.5=half, negative=reverse).

  • export_list_presets

    List all available render presets for final video output.

  • export_render

    Render the project to a video file via melt.

  • export_xml

    Generate Kdenlive/MLT XML for the current project.

  • filter_add

    Attach a video/audio effect to a timeline clip.

  • filter_list

    List all active filters on a specific timeline clip.

  • filter_list_available

    Discover all filters the Kdenlive runtime exposes.

  • filter_removewrite action

    Detach an effect from a clip.

  • filter_set_paramwrite action

    Update a single parameter on an active filter.

  • guide_add

    Place a navigation guide marker along the timeline.

  • guide_get

    Get single guide by ID.

  • guide_list

    Return all guide markers on the timeline.

  • guide_removewrite action

    Delete a guide marker by its ID.

  • guide_updatewrite action

    Update guide properties.

  • marker_add

    Add timeline or clip marker (markers separate from guides).

  • marker_list

    List all markers.

  • marker_removewrite action

    Remove marker by ID.

  • project_get_info

    Return project metadata: FPS, resolution, track layout, bin clip count.

  • project_get_profile

    Get the current project's video profile (resolution, FPS, aspect ratio).

  • project_get_render_profiles

    Alias for project_list_profiles - get available render presets.

  • project_list_profiles

    Enumerate all available video output profiles (hd1080p30, 4k60, sd_pal, etc.).

  • project_newwrite action

    Create a brand new Kdenlive project session.

  • project_open

    Load an existing .kdenlive-cli.json project into the session.

  • project_save

    Persist the current project state to a file.

  • project_set_profile

    Set or update the project's video profile.

  • render_queue_add

    Add job to render queue.

  • render_queue_list

    List render queue jobs.

  • render_queue_start

    Start processing render queue (renders sequentially via melt).

  • render_queue_status

    Get render queue status.

  • render_queue_stop

    Stop render queue (marks running as stopped).

  • session_history

    List all undo/redo history entries with descriptions.

  • session_redo

    Reapply the last undone operation.

  • session_redo_step

    Redo N steps (granular).

  • session_status

    Inspect session state: project loaded, modified flag, history depth.

  • session_undo

    Revert the most recent state change (up to 50 history entries).

  • session_undo_step

    Undo N steps (granular).

  • timeline_add_clip

    Place a bin clip onto a specific track at a given time position.

  • timeline_add_track

    Append a video or audio track to the timeline.

  • timeline_get_duration

    Get total timeline duration in seconds (max end time).

  • timeline_get_info

    Get comprehensive timeline info: tracks+clips, duration, position, zoom, guides, markers, profile.

  • timeline_get_position

    Get current playhead position.

  • timeline_get_zoom

    Get timeline zoom level.

  • timeline_list

    Return all timeline tracks with clip counts, IDs, mute/lock status.

  • timeline_move_clip

    Reposition a clip on the same track to a new time position.

  • timeline_remove_clipwrite action

    Delete a clip from the timeline.

  • timeline_remove_trackwrite action

    Delete a track and all its clips from the timeline.

  • timeline_seek

    Seek playhead to position (seconds).

  • timeline_set_zoom

    Set timeline zoom level (0.1 .. 10.0).

  • timeline_split_clip

    Cut a clip into two independent pieces at a precise time offset.

  • timeline_trim_clip

    Adjust the in/out trim handles of a timeline clip (not the crop filter).

  • track_get_info

    Get detailed info for a single track (including clips).

  • track_move_down

    Move track down one position (swap with next).

  • track_move_up

    Move track up one position (swap with previous).

  • track_set_hidden

    Hide/show a track (video visibility).

  • track_set_locked

    Lock/unlock a track.

  • track_set_muted

    Mute/unmute a track (audio).

  • track_set_name

    Rename a track.

  • transition_addwrite action

    Create a blend transition (crossfade, wipe, etc.) between two track layers.

  • transition_list

    List all transitions on the timeline.

  • transition_removewrite action

    Delete a transition by its numeric ID.

  • transition_set

    Modify a parameter on an existing transition.

Public scan report

scanner v0.1.10 · 2026-10-16 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 2 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Kdenlive MCP Server compares

Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 88% of 1,336 Media servers
Tools
73
the typical Media server has 6
Tools that change things
16%
typical: 3%. Fewer write tools means less an agent can break
GitHub stars
5
more than 83% of 716 Media servers
Downloads a week
52
more than 39% of 372 Media servers with a package

What its tools let an agent do: 59 read · 14 change

Install Kdenlive MCP Server in Claude Code, Cursor or VS Code

claude mcp add kdenlive-mcp-server -- uvx kdenlive-mcp-server
Add to Cursor

What the publisher says

From the Kdenlive MCP Server repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.va1bhav512/kdenlive-mcp-server -->

Kdenlive MCP Server

A Model Context Protocol (MCP) server wrapping cli-anything-kdenlive for LLM-driven video editing workflows via Kdenlive.

Overview

This FastMCP server enables AI models to perform complex video editing tasks on Kdenlive projects through a unified set of 36 tools organized into 8 functional categories. The server uses the Python API of cli-anything-kdenlive directly (not subprocess) to maintain a persistent session state, ensuring modifications are immediately available to subsequent tool calls.

Key Features

  • Persistent Session State: Uses CLI's in-memory session API, auto-saves after every mutation
  • Gen 5 XML Export: Kdenlive-compatible XML output with proper bin references and version metadata
  • Robust Error Handling: All exceptions caught and returned as structured JSON payloads
  • Auto-Project Tracking: Globally tracks project path; all tools automatically target the active project
  • 36 MCP Tools: Comprehensive coverage of Kdenlive operations

Installation

Prerequisites

# Python 3.10+
# Ensure uv is installed for dependency management
pip install uv

Install Dependencies

cd kdenlive-mcp-server
uv sync

Usage

As an MCP Server

The server runs as a FastMCP server compatible with any LLM platform that supports MCP (e.g., Claude Code, Pi, OpenCode).

Command Line

# Run the MCP server
uv run kdenlive-mcp

# Or directly via Python
uv run python3 -m kdenlive_mcp_server.server

Python Integration

from kdenlive_mcp_server.server import (
    project_new, bin_import_clip, timeline_add_clip, export_xml
)

# Create project
result = project_new(output_path="my_project.kdenlive-cli.json", profile="hd1080p30")

# Import media
result = bin_import_clip(clip_path="video.mp4", name="Interview", duration=120.0)

# Add to timeline
result = timeline_add_clip(clip_id="clip0", track=0, position=0.0)

# Export XML
result = export_xml(output_path="output.kdenlive")

Project Structure

kdenlive-mcp-server/
├── kdenlive_mcp_server/
│   ├── __init__.py           # Empty package init
│   └── server.py             # FastMCP server with 36 tools (876 lines)
├── main.py                   # Entry point delegating to server module
├── pyproject.toml            # Project configuration and dependencies
├── uv.lock                   # Dependency lock file
└── README.md                 # This file

Tools

Project (5 tools)

Bin (4 tools)

Timeline (8 tools)

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Kdenlive MCP Server: common questions

Is Kdenlive MCP Server safe?
Yes, by our scan: it is graded A (92/100). Read the Kdenlive MCP Server safety report
How do I install Kdenlive MCP Server?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Kdenlive MCP Server need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Kdenlive MCP Server maintained?
The last commit was 22 days ago (2026-10-14). The latest release is v0.1.3.
What can I use instead of Kdenlive MCP Server?
Servers from other publishers that do the same job: Luw.ai MCP server, Kinocut MCP server and StudioMeyer Video MCP server. Compare all Kdenlive MCP Server alternatives.
How does Kdenlive MCP Server compare with other Media MCP servers?
safety score 92/100 (higher than 88% of 1,336 Media servers); tools 73 (the typical Media server has 6); tools that change things 16% (typical: 3%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Kdenlive MCP Server

Same job from other publishers: the closest match first, then the best rated.

All Kdenlive MCP Server alternatives →
  • Luw.ai
    AI interior, exterior and landscape design, photoreal rendering, image editing, video and 3D.
    A
  • Kinocut
    Guardrailed video editing for AI agents: FFmpeg, captions, effects, Hyperframes, and receipts.
    B
  • StudioMeyer Video
    Video production: recording, editing, effects, captions, TTS, screenshots. 8 tools.
    B
  • Katto
    AI video clipping MCP: long videos and podcasts into scored, captioned 9:16 shorts.
    B
  • Remove AI Watermarks
    Identify and remove AI watermarks and provenance metadata from your own images and video.
    A