Mocut for Codex
Let Codex edit your video in the Mocut editor while you watch: cuts, captions, titles and motion graphics. Every change shows up live and can be undone.
Set it up with one prompt
Paste this into Codex:
Read https://mocut.app/codex and set up Mocut for me.
Works on every Mocut plan, including Free.
Instructions for Codex
You are setting up the Mocut MCP server (https://mcp.mocut.app/mcp) for this user. Do these steps in order and tell the user briefly what you did after each one.
-
Check whether Mocut is already added. If Mocut's tools (such as
get_editor_state) are already available in this session, Mocut is connected: skip to step 4. Otherwise run:codex mcp list
If it lists
mocutwithhttps://mcp.mocut.app/mcp, skip to step 3. -
Add Mocut. Run:
codex mcp add mocut --url https://mcp.mocut.app/mcp
If you cannot run
codexcommands, ask the user to run these commands in a terminal instead. -
Start the sign-in. Tell the user first: "Your browser will open Mocut's page. Sign in to Mocut, check the app name, and click Allow." Then run:
codex mcp login mocut
It opens the browser and waits until the user clicks Allow, so allow it up to 5 minutes. If it says it needs an interactive terminal, run it through
script:script -q /dev/null codex mcp login mocuton macOS, orscript -q -c "codex mcp login mocut" /dev/nullon Linux. If that fails too, ask the user to runcodex mcp login mocutin their own terminal. -
Open your own editor window. If you run inside the Codex app (it has a built-in browser), open
https://editor.mocut.app/?agent-window=1in that browser and keep it in view: it is your own Mocut window, and calls go to it before any other tab. Ask the user to sign in there once and click Allow in the bar at the top. Without a built-in browser, ask the user to open editor.mocut.app, open the project they want edited, and turn on Account menu → Connected agents → Allow connected agents. -
Finish. Mocut's tools load when Codex starts. Tell the user to start a new Codex session and ask for an edit, for example "Add captions to my video".
How to work with Mocut (for Codex, in later sessions)
- Start with
get_editor_state, thenget_timeline. Name every clip or track by id: no tool uses the user's selection unless you pass its ids. - Before writing motion graphics, read
get_mocut_guidewith topicmotion_graphics. Then usecreate_composition/edit_compositionand look at the result withrender_framesbefore saying it is done. - Clearing the timeline, broad deletes, unlocking tracks, deleting folders and anything that spends credits need the user's yes. Codex shows Mocut's question in the conversation with Allow this time, Always allow or Don't allow; "Always allow" is saved for the project in Mocut (Settings → Permissions). Credits also follow the project's AI permission there. With the approval policy "never", Codex declines these questions by itself, and Mocut then asks on a card in the editor instead. If the user declines, ask before trying again.
- To change the project's AI permission, ask the user in your chat which they want (Always allow, Ask each time or Don't allow), then call
set_generation_permission. Ask each time and Don't allow are saved at once; Always allow is saved after the user confirms it in Mocut's own question. - Calls answer within about 50 seconds; longer work returns a
jobIdto follow withwait_for_job. - With a built-in browser, work in your own editor window:
get_editor_statereturns its link aseditorUrl. - Before a multi-step change call
agent_statuswithworkingand a short label, anddonewhen you finish: the user's timeline stays locked while you work and shows your label. Astopped_by_useranswer means the user pressed Stop; ask before editing again. - To use a file from the user's computer:
create_media_upload, run the returned command, thenimport_media. The file goes to the user's Mocut Cloud storage. On the Free plan there is no cloud storage, so ask the user to drag the file into the editor instead. The command needs network access, so Codex may ask to run it outside its sandbox. - If a tool says the editor is closed, outdated or not allowed, ask the user to open the editor, reload it, or switch on "Allow connected agents".
Troubleshooting
- Disconnect: Account menu → Connected agents → Disconnect, or
codex mcp remove mocut.
Using Claude instead? See mocut.app/claude.