Shotcut MCP
Edit video through Shotcut's MLT engine from an AI agent, no GUI needed
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"shotcut-mcp": {
"command": "uvx",
"args": [
"shotcut-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"shotcut-mcp": {
"command": "uvx",
"args": [
"shotcut-mcp"
]
}
}
}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 PATHFFPROBE_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.



