Skip to content
MCP server

Shotcut MCP

Edit video through Shotcut's MLT engine from an AI agent, no GUI needed

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.2.1
Listing updated
today

Similar MCP servers

About Shotcut MCP

Shotcut MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Instead of driving the Shotcut interface, this server builds a native Shotcut .mlt project on disk and changes it one tool call at a time. The result is an ordinary project file, so you can open the agent's rough cut in Shotcut afterwards and carry on by hand.

Edit state lives in a .state.json file beside each .mlt, and the project file is regenerated after every change. Clip ids stay stable between calls, which lets an agent trim, split or move a clip it created earlier. Rendering goes through the melt binary, and ffprobe is used to read source durations and check renders.

It has real limits. There is one video track only, hand edits made in the Shotcut GUI are overwritten by the next tool call, and the style option on transitions currently renders only a dissolve. Windows rendering is not yet covered by the project's CI.

Install

Run in a terminal

claude mcp add shotcut-mcp -- uvx shotcut-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "shotcut-mcp": {
      "command": "uvx",
      "args": [
        "shotcut-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shotcut-mcp": {
      "command": "uvx",
      "args": [
        "shotcut-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "shotcut-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "shotcut-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shotcut-mcp": {
      "command": "uvx",
      "args": [
        "shotcut-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "shotcut-mcp": {
      "command": "uvx",
      "args": [
        "shotcut-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SHOTCUT_MCP_WORKDIRDirectory for .mlt projects and state files (default ~/shotcut-mcp-projects)
  • MELT_BINPath to the MLT melt binary if it is not on PATH
  • FFPROBE_BINPath to ffprobe if it is not on PATH

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

create_project
Create a new project with a frame size and frame rate
add_clip
Append a span of a source video to the end of the timeline
trim_clip
Change a clip's source in and out points
remove_clip
Ripple-delete one clip
move_clip
Move a clip to a new position on the timeline
split_clip
Split a clip into two at a point inside it
remove_segment
Ripple-delete a span of the timeline
append_text_overlay
Burn a text title onto the timeline between two times
apply_filter
Apply a brightness, volume, crop or fade filter to a clip
set_transition
Crossfade video and audio between two adjacent clips
get_timeline
Return the whole edit including clips, filters, transitions and titles
project_info
Return summary metadata for a project
render
Render a project to a video file with melt
list_projects
List the projects in the work directory

What it does

Native project output
Writes a Shotcut .mlt project you can reopen and keep editing in the app.
Timeline editing
Add, trim, split, move and ripple-delete clips or whole segments.
Filters
Apply brightness, volume, crop and audio or video fade filters to a clip.
Titles and crossfades
Burn text titles over a time range and crossfade between adjacent clips.
Timeline readback
Returns clips, in and out points, filters, transitions and titles so the agent can check its work.
Rendering with melt
Renders a project to a video file using the melt binary.

Good for

  • Assemble a promo from two clips with a crossfade and a title
  • Trim source footage to fixed-length highlights
  • Add fade-in and fade-out to a batch of clips
  • Produce a rough cut to polish in Shotcut by hand
  • Render a finished project from a script or agent run

Pricing

Open source

MIT licensed; free to use

Shotcut MCP FAQ

What do I need installed besides the server?

Python 3.11 or newer, the MLT `melt` binary (included with Shotcut) and `ffprobe` from FFmpeg. Set MELT_BIN or FFPROBE_BIN if they are not on PATH.

Can I keep editing in Shotcut afterwards?

You can open the .mlt project in Shotcut, but the next tool call overwrites manual GUI edits, so finish agent edits first.

Does it support multiple tracks?

Not yet. The README lists a single video track and says multitrack video and audio is planned.

Why raise the client timeout?

Renders take longer than goose's default, so the README suggests a timeout of 600 seconds or more.

Is Shotcut MCP free?

Yes. Shotcut MCP is open source, so you can use and self-host it for free.

How do I add Shotcut MCP to Claude Code?

Run this command in your terminal: claude mcp add shotcut-mcp -- uvx shotcut-mcp

What are the best alternatives to Shotcut MCP?

The closest alternatives to Shotcut MCP are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers