Shotcut MCP

Create, edit, validate, preview, and render Shotcut projects through AI clients.

Connector by matrodrigs · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 22

Chalk Labs

Need help deploying Shotcut MCP?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Desktop. Read the repository before you give any tool access to your data.

Download the bundle

MCP bundle (.mcpb): open it with Claude Desktop.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Create, edit, validate, preview, and render Shotcut projects through AI clients.

Use cases: audio-video

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools: 15 read · 5 write · 0 delete · 8 not yet classified
Secrets: None asked for
Install scripts: None found
Runs as: Downloaded binary

Tools by what they do 28

Read from the source code; the running server may list different tools.

Read 15 · Look things up without changing anything.

analyze_media_quality
describe_mlt_service
detect_hardware_encoders
discover_media
inspect_project
list_mlt_services
list_project_backups
list_render_jobs
plan_project_edit
render_preview
render_preview_batch
render_review_clip

Show 3 more tools

render_status
shotcut_status
validate_project

Write 5 · Create, change, send or run things.

cancel_render
create_project
edit_project
restore_project_backup
start_render

Not yet classified 8 · We could not tell from the name and description.

diagnose_color_workflow
diagnose_missing_media
export_marker_chapters
open_in_shotcut
probe_media
render_contact_sheet
shotcut_capabilities
shotcut_doctor

Network hosts it talks to 2

github.com · found in install command, code
matrodrigs.github.io · found in code

Files it touches

Your home directory (~)

Tools (28)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

analyze_media_quality
Use before proposing cleanup or delivery edits. Runs installed FFmpeg analyzers for silence, black frames, freezes, interlacing, and loudness and returns bounded structured measurements without changing the media.
cancel_render
Use only when the user asks to stop an active render. Requests supervised cancellation, including after an MCP restart.
create_project
Description is built at runtime.
describe_mlt_service
Use after list_mlt_services to learn one installed service's accepted properties and local MLT metadata.
detect_hardware_encoders
Use when choosing or troubleshooting hardware export. Lists advertised FFmpeg encoders and smoke-tests OS-appropriate candidates.
diagnose_color_workflow
Use for washed-out colors, HDR/SDR questions, or export compatibility. Reports normalized source color facts and supported color-workflow constraints.
diagnose_missing_media
Use when media is missing or offline. Searches authorized roots and ranks candidates without changing the project. Apply a source mapping the user already specified; otherwise let the user choose before relinking.
discover_media
Use when the user supplies a source folder. Lists media candidates by extension in deterministic pages, with optional bounded stream metadata. Respects path policy and skips directory symlinks; use probe_media to inspect individual files and do not infer visual content from filenames.
edit_project
Use only after inspect_project. Applies up to 500 related operations in one validated atomic write; prefer item_ref and animate_clip for robust creative batches. Pass expected_revision and re-inspect on conflicts instead of force. Summarize committed operation results, and after visual edits show a managed contact sheet or exact preview.
export_marker_chapters
Use to create Shotcut-compatible chapter text from point markers. Optionally includes range markers or selected marker colors and atomically protects an existing output.
inspect_project
Use first to understand a timeline or before planning, editing, or restoring. Returns SHA-256 revision, stable item_ref selectors, and paginated structural state. Use summary for less detail, track/frame filters to focus, and pagination.next_offset with expected_revision to continue. Use render_contact_sheet for visual review.
list_mlt_services
Use when an edit needs an unfamiliar native MLT effect or transition. Lists services of one kind installed with Shotcut.
list_project_backups
Use before undo or recovery. Lists only backups owned by this project, including paths, revisions, sizes, and timestamps.
list_render_jobs
Use for 'the latest render', render history, or when job_id is unknown. Returns bounded newest-first durable summaries.
open_in_shotcut
Use only when the user asks to open the GUI. Opens a project, media file, or folder in Shotcut; MCP edits do not require this.

Show 13 more tools

plan_project_edit
Use for a dry run, uncertain edit, or user review before committing. Applies operations in memory using stable item_ref selectors when supplied, validates with MLT, and returns a snapshot and diff without changing the project.
probe_media
Use to understand a source file before editing. Reads duration, codecs, resolution, frame rate, color, and audio with per-file caching.
render_contact_sheet
Use for 'show me the edit', visual review, or a timeline overview. Renders exact frames or 12 evenly sampled frames into one image; omit output_path for managed output.
render_preview
Use to show or inspect one specific moment. Renders one PNG and returns its path; omit output_path for a bounded server-managed preview.
render_preview_batch
Use when exact frames are needed as separate image files. Renders up to 64 requested frames; use render_contact_sheet for one overview image.
render_review_clip
Use to review pacing, transitions, motion or sound. Renders at most 30 seconds to a managed H.264/AAC MP4 within 1280x720, preserving aspect ratio. This temporary review is separate from final export and replaces only the previous managed review for this project; surface the playable resource or path to the user.
render_status
Use when job_id is known; poll until a terminal state and surface meaningful status, progress, or ETA changes without narrating unchanged polls or raw logs. On completion, present both returned artifacts: rendered media and the exact editable project. Use list_render_jobs when the id is unknown.
restore_project_backup
Use after list_project_backups and authorization to restore the selected backup; an explicit request identifying that backup is sufficient. Validates and atomically restores it while backing up the current project; pass the current expected_revision unless force=true was explicitly authorized.
shotcut_capabilities
Use before an unfamiliar edit. Omit operation for the catalog, presets, compatibility, and workflow; pass operation for only its complete schema, example, and transaction guarantees enforced by plan and edit.
shotcut_doctor
Use after installation, upgrade, or a setup failure. Distinguishes tested Shotcut/MLT combinations, untested-version warnings, and runtime failures. Checks repository startup, RNNoise, FFmpeg quality-analyzer availability, and path policy. An untested version alone does not block project operations.
shotcut_status
Use for a quick readiness check. Locates Shotcut, Melt, FFprobe, and FFmpeg and reports their versions; use shotcut_doctor for compatibility diagnosis.
start_render
Use only after the user explicitly requests export or approves a preflight summary of project, output, preset, range or duration, and overwrite behavior; never infer export from edit completion, and do not ask twice after an explicit request. Starts one revision-bound durable render and exact editable project snapshot; pass expected_revision when known and monitor job_id with render_status.
validate_project
Use when saved-project readiness is unknown or media/service dependencies changed before preview or render; edit_project already validates its candidate, so do not repeat this after every successful edit. Checks XML, local resources, required installed MLT services, and first-frame Melt processing; this is not visual-quality analysis.

Signals

Stars: 22
Forks: 3
Open issues: 0
Contributors: 2
Last commit: Oct 17, 2026 (14 days ago)
Last release: Oct 17, 2026 (14 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.matrodrigs/shotcut-mcp
Version: 1.6.0
Auth: No auth
Packages: mcpb https://github.com/matrodrigs/shotcut-mcp/releases/download/v1.6.0/shotcut-mcp-1.6.0.mcpb
License: MIT
Repository: github.com/matrodrigs/shotcut-mcp
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped: 50+; launches shipped
media placements: 500+; media placements
founders on every account: 2; founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get Shotcut MCP running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Need help deploying Shotcut MCP?

Call Get help

Cite this page

Shotcut MCP. Agent Mart. https://agentmart.dev/connectors/matrodrigs-shotcut-mcp (last updated 2026-10-24)