# Shotcut MCP

> Shotcut MCP is an open-source MCP server for design and media. Edit video through Shotcut's MLT engine from an AI agent, no GUI needed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/nobanks/shotcut-mcp
- **MCP Registry name:** io.github.NoBanks/shotcut-mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add shotcut-mcp -- uvx shotcut-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Meigen AI MCP](https://ai-powered.com/mcp/meigen-ai-mcp): Meigen AI MCP is an open-source MCP server for design and media.
- [Z-Image MCP](https://ai-powered.com/mcp/z-image-mcp): Z-Image MCP is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/shotcut-mcp
