ReadyToEdit guides
All guides
Start here5 minute read

Use ReadyToEdit from your AI agent

Connect Claude, Codex or Cursor to the ReadyToEdit MCP once, add the skills, and get back a draft with its footage ready to play, and the editor link.

What the MCP gives your agent

ReadyToEdit is the workspace where the video is made: your footage, scripts, audience, style and post numbers, the Footage preview, the editor link and cut review. Claude, Codex or Cursor is the writer you bring. Through the ReadyToEdit MCP it reads what the project holds, saves its script, puts your clips on the lines and hands you the Footage preview and the editor link. Your agent works as you: it reaches the projects your account can reach, and nothing else.

PlanWho writes the script and places the clipsWhat ReadyToEdit does
LightYour AI. It writes the lines and puts your clips on them, and ReadyToEdit saves them as written. It does not watch your videos: it places a clip by its file name, folder and recording date, a description saved with an upload, and what you tell it. ReadyToEdit runs no AI of its own on Light.Keeps your footage, documents, audience, style and post numbers; plays your videos and takes clips from them; makes the Footage preview and the editor link, and runs cut review.
FullYour AI, or ReadyToEdit’s own writer, which drafts from an idea and what the project holds, with its footage finder placing a clip on each line.Everything on Light, and it reads your footage itself: descriptions, transcripts and search by meaning.

Connect it once

You need a ReadyToEdit account with at least one project. Pick the steps for the agent you use. In Claude Code, use the plugin or the server alone, not both: both together connect the same server twice.

  1. 1

    Claude Code, with the plugin

    In Claude Code, run /plugin marketplace add https://readytoedit.ai/agent/marketplace.json, then /plugin install readytoedit@readytoedit. It adds the MCP server and the five skills below. Then type /mcp, choose the ReadyToEdit server, choose Authenticate and sign in when your browser opens. New versions do not arrive by themselves: run claude plugin update readytoedit@readytoedit in your terminal, or type /plugin, open Marketplaces, choose readytoedit and turn on Enable auto-update.

  2. 2

    Claude Code, the server alone

    Run claude mcp add --transport http --scope user readytoedit https://readytoedit.ai/api/mcp. Then type /mcp, choose readytoedit, choose Authenticate and sign in. Add the skills from the file below if you want them.

  3. 3

    The Claude app or claude.ai

    Download https://readytoedit.ai/agent/readytoedit-plugin.zip. Open Customize, then Plugins, choose Add, then Upload plugin, and pick the file. Open the plugin’s Connectors tab, add ReadyToEdit and sign in. A plugin you upload there also reaches Claude Code when you sign in with the same Claude account. It does not update by itself: for a newer version, choose Remove from the plugin’s menu and upload the new file. For the server alone: Customize, then Connectors, + Add, Add custom connector, and paste https://readytoedit.ai/api/mcp. On Team and Enterprise plans an Owner adds the connector under Organization settings, then Connectors, and you connect it with your own account.

  4. 4

    Codex

    Run codex mcp add readytoedit --url https://readytoedit.ai/api/mcp, then codex mcp login readytoedit and sign in. The Codex CLI, the IDE extension and the ChatGPT desktop app share this setting; in the extension or the app you can choose Authenticate instead. For the skills, unzip the skills file below into ~/.agents/skills.

  5. 5

    Cursor

    Add ReadyToEdit to ~/.cursor/mcp.json: {"mcpServers": {"readytoedit": {"url": "https://readytoedit.ai/api/mcp"}}}. Sign in with your ReadyToEdit account when Cursor connects. For the skills, unzip the skills file below into ~/.agents/skills.

  6. 6

    Sign in

    Sign in with the account you use here and approve access on the screen that follows. There is no key to copy.

The ReadyToEdit skills

A skill gives your agent the steps for a whole job, so one sentence from you is enough. There are five, and each works on Light and Full.

Claude Code and the Claude app get them with the plugin, which also adds the server; in Claude Code you can then type /readytoedit: and pick one. If you already added the server with claude mcp add, do not install the plugin too: unzip the skills instead, as below. For Codex, Cursor, or Claude Code without the plugin, download https://readytoedit.ai/agent/readytoedit-skills.zip and unzip it: mkdir -p ~/.agents/skills && unzip -o readytoedit-skills.zip -d ~/.agents/skills. Codex and Cursor both read ~/.agents/skills; for Claude Code, unzip it into ~/.claude/skills instead. To update them, download the file and run the same command again.

SkillSay to your agentWhat comes back
Show what you built, for developers and founders who build with AI“Show me what you built.” after a feature or a fix.A Footage preview of the change: your agent’s write-up with the recordings of the change on the lines they show, so you see what was made. For a web app your agent can record the new flow in its own browser, with your OK; otherwise you record it and point your agent at the file.
Editor handoff, for creators with an editor“Get this Drive folder ready for my editor: a 40-second video on the spring menu.”The lines with a clip and an instruction on each, the Footage preview to check, and the editor link to forward.
Client revisions, for editors and agencies“Work through the client’s notes on the launch video.”Each request answered in that client’s draft, a table of what changed and what is still open, and the same editor link, updated.
What’s working, for anyone who posts“What is working on my channels, and how do my posts compare with the ones I saved?”Your posts ranked against your own usual, set beside the posts you saved, and what the best ones share.
Write in their voice, for creators and founders“Write a 45-second video on our new pricing, in my voice.”Lines written from the audience and style you set and the posts that worked, your clips on them, and the Footage preview.

Ask for a draft

Tell your agent what the video is, in a line or a paragraph, the way you would tell your editor. Your agent writes the lines and ReadyToEdit saves them as written, then your agent puts a clip on each line it has footage for, such as a recording it made or a file you described. On Full, your agent can send the idea instead, and ReadyToEdit’s writer drafts it from what the project already holds.

If you have more than one project, say which one the video is for.

Say to your agent
“Write a ReadyToEdit draft: a 45-second video on why we rebuilt search, for people who already use the app. Put my two screen recordings on the lines they show.”

What you get back

LinkWhat it opens
Footage previewThe draft in Studio, with Footage preview open on its clips in script order, ready to play with one press. Close it to change a line or swap a clip.
Editor linkA read-only page with the script line by line, the clip on each line and its own Footage preview. It opens without an account, so you can send it to your editor. Asking again updates the same page.

When you want more

Ask it toWhat happens
Use a fileIt sends a document you point it at, such as design notes or a README, complete, attached to the Piece it belongs to. Sending the same file again replaces the old version.
Bring in a Drive folderIt links the videos in a Google Drive folder rather than copying them, so they play and take clips. On Full, ReadyToEdit can also read them: describing what is on screen takes a few minutes a video and is billed like any other use, so your agent asks you first. Speech is transcribed only for the videos you choose to transcribe in Studio.
Upload a videoIt uploads a video file from your computer, up to 500 MB, for footage that is not in Google Drive, and says what is on screen when it knows. On Full, ReadyToEdit also reads it, the same as an upload in Studio.
Change a draftIt changes the draft you already have instead of writing another: its lines, title and caption, and the clips on each line. It can delete a draft you no longer need, and on Full it can search your footage again for chosen lines. A draft in review, approved or shipped is left as it is.
Read the draftIt reads the lines back to you, with the clips placed on them.
See what workedIt reads the posts from the accounts you connected and the ones you shipped through ReadyToEdit, with their views, likes, comments and shares over time, and the posts you saved from other accounts, kept apart from yours.
Read what was saidIt reads the words of a video, a document or a post: its description, a transcript where there is one, or the full text.
Answer a reviewIt reads what your reviewer asked for on a draft, in their own words, and the notes on a cut at their timecodes, then answers them in the same draft.
Write to your audienceIt reads the audience, goals and style you set for the project in Studio before it writes.

Footage in Google Drive

ReadyToEdit reaches a Drive folder as its own Google account, so the folder must be shared with that account as a viewer. If it is not shared yet, Studio and your agent both name the address to share it with. Share one folder once and record into folders inside it: everything inside is shared with it too.

Sharing gives ReadyToEdit’s account access to those files and gives no other Google account access. On Full, it reads a video only when you ask, deletes its temporary copy afterwards, and keeps the transcript, stills and descriptions. Unshare the folder to stop it.

What it does not do

It does not send anything to your editor or publish. You send the editor link yourself. The drafts it starts appear in Studio like any other, where you can change any line or clip.

Keep going