
OpenChatCut MCP Setup for Claude Code, Codex and Other Apps
Lets Claude Code, Codex and other agents edit video projects in the OpenChatCut editor on your computer.
OpenChatCut is an open-source, local-first video editor, and its built-in MCP endpoint lets an outside agent work on the same timeline. You run the editor yourself, then point your agent at a local address. By default edits go into a draft that you review and approve inside the editor. The tool list on this page is partial, because most editing tools are registered by the open editor.
Good for
- Video editors who want Claude Code or Codex to cut, caption and arrange clips
- Developers automating edits on a real project
- People who want an AI editor that keeps projects on their own machine
Works in
2 supported · 9 should work
Tap an app to see how to set it up and any known problems.
README gives the claude mcp add command. GitHub
README gives the config.toml entry. GitHub
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Not documented. Works only if n8n runs on the same machine as the editor.
Custom connectors are reached from Anthropic's servers, which cannot open localhost.
ChatGPT connectors call public URLs; the endpoint is localhost on your machine.
Install OpenChatCut MCP
Claude Code
- 1
Copy this prompt.
Add the OpenChatCut MCP server to Claude Code. Run this command: claude mcp add --transport http openchatcut http://localhost:5199/api/external-mcp/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires OpenChatCut editor running locally.
Start OpenChatCut (see its quick start) and open your project before connecting. The address is local to your machine. If you set OPENCHATCUT_MCP_TOKEN, add an Authorization header with the Bearer token to the client config.
Built from the package data we hold. Not yet tested by us.
Tools
Starts a safe edit session on a project
Opens a draft copy of the project that the agent edits. Nothing changes in the real timeline until the edit is reviewed and approved.
Try: “Start an OpenChatCut edit session for my trailer project.”
Write ·
begin_edit_sessionChecks where an edit session stands
Returns the state of a session, including whether the draft was approved, rejected or went stale.
Try: “Check if my edit session was approved.”
Read ·
get_edit_sessionSubmits the draft for approval
Sends the finished draft for review. In manual mode you approve it in the editor, and in auto mode it applies right away.
Try: “Submit the draft for review.”
Write ·
review_edit_sessionLists your video projects
Returns your OpenChatCut projects, newest first.
Try: “List my OpenChatCut projects.”
Read ·
list_projectsCreates an empty project
Makes a new project with one timeline and one video track.
Try: “Create a project called Launch Teaser.”
Write ·
create_projectBinds the connection to one project
Ties this MCP session to a project in the open editor, or to a saved project when the editor is closed. The binding is permanent for the session.
Try: “Work on the Launch Teaser project.”
Write ·
target_projectGives the link to open a project
Returns the editor address for the current or a named project.
Try: “Give me the link to open this project.”
Read ·
get_editor_urlShows what is connected
Reports connected editors, this session's project binding and capability status.
Try: “Is OpenChatCut connected?”
Read ·
openchatcut_status
Read from the source code
Permissions
high risk · 3 things to watch
High risk
The assistant can create projects and change timelines, and in auto approval mode it applies edits without asking you. Keep the default manual approval, and leave the local address unexposed unless you set a token.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Auto mode applies edits without your review
With approvalMode set to auto, the draft is applied the moment it is submitted. Use manual mode so you approve each change in the editor. github.com
Outside edit sessions, tools act immediately
The README says generation, export, project deletion and other side-effect tools are kept out of edit sessions because they cannot be rolled back. Outside a session they can run directly. github.com
Protect the endpoint if you expose it
The bridge is built for one user on one machine. If you expose it, set a bearer token and restrict network access. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. In edit sessions the agent works on a draft and manual approval protects the timeline. |
|---|---|
| Talks to | Your local OpenChatCut editor. AI model or generation services you configure in the editor |
| Sign-in and keys | No account for the local endpoint. If you expose it, set OPENCHATCUT_MCP_TOKEN and clients send it as a Bearer token. |
Questions
Is the OpenChatCut MCP server official?
Yes. It ships inside the OpenChatCut app repo, and the project says it is independent of the commercial ChatCut product.
Do I need to run OpenChatCut first?
Yes. Start the editor and open the project before using timeline tools. Listing, creating and navigating projects work without the editor open.
What is the OpenChatCut MCP server address?
http://localhost:5199/api/external-mcp/mcp, a Streamable HTTP endpoint on your own machine.
Is it free?
Yes. OpenChatCut is open source under AGPL-3.0 or later. Any cloud AI or generation service you connect has its own costs.
Can I use my Claude subscription?
Yes, through Claude Code over the local MCP connection. The README says OpenChatCut does not collect Claude sign-in details, and the built-in agent needs an API key.
How many tools does it have?
The list here is partial. The editor registers many editing tools when a project is open, so the count depends on the open editor.
Which clients are documented?
The README gives setup for Codex, Claude Code, Qoder and Qwen Work.
Can I use it with Claude Desktop or ChatGPT?
No. The endpoint is http://localhost:5199 on your computer. Claude Desktop custom connectors and ChatGPT connectors are reached from the vendor's servers, which cannot open a localhost address. Use Claude Code or Codex on the same machine.
Information
updated Nov 2, 2026
- Publisher
- Official
- Transport
- Streamable HTTP
- Auth
- None
- License
- AGPL-3.0
- Last commit
- Oct 21, 2026
- Open issues
- 14
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com