← Back to the vault

Instagram Edits + Claude Code

Let Claude cut your video in Edits

Connect the Edits desktop app to Claude once, then ask for a clean cut in plain English. Claude reads the transcript, finds the dead air, makes the cuts, adds captions and effects, and checks its own work.

Raw take 23.50sHatched = silence removedEdit 23.17s

Part 1

Setup, about 10 minutes

You need a Mac with the Edits app, Claude Code (desktop app or terminal), and Node.js installed. Everything stays on your computer and talks over 127.0.0.1.

  1. Turn on the Automation Server in Edits

    Open Edits and enable its automation or MCP server. It listens on 127.0.0.1:19501 and gives you a bearer token. Copy the token. The menu name may differ between app versions, so look for "Automation" in the settings.

  2. Run the small shim

    Claude Code rejected Edits' tool list because its replies left out two fields (ttlMs and cacheScope). This 30-line proxy adds them. Save it as proxy.js and leave it running.

    proxy.js
    const http = require('http');
    const UP = { host: '127.0.0.1', port: 19501 };
    http.createServer((req, res) => {
      const chunks = [];
      req.on('data', c => chunks.push(c));
      req.on('end', () => {
        const body = Buffer.concat(chunks);
        const headers = { ...req.headers, host: `${UP.host}:${UP.port}` };
        delete headers['content-length'];
        const up = http.request({ ...UP, path: req.url, method: req.method,
          headers: { ...headers, 'content-length': body.length } }, ur => {
          const out = [];
          ur.on('data', c => out.push(c));
          ur.on('end', () => {
            let buf = Buffer.concat(out);
            if ((ur.headers['content-type'] || '').includes('application/json')) {
              try {
                const patch = m => {
                  const r = m && m.result;
                  if (r && typeof r === 'object' && (r.tools || r.resources || r.prompts || r.resourceTemplates)) {
                    if (typeof r.ttlMs !== 'number') r.ttlMs = 0;
                    if (!['public', 'private'].includes(r.cacheScope)) r.cacheScope = 'private';
                  }
                  return m;
                };
                const j = JSON.parse(buf.toString());
                buf = Buffer.from(JSON.stringify(Array.isArray(j) ? j.map(patch) : patch(j)));
              } catch {}
            }
            const h = { ...ur.headers, 'content-length': buf.length };
            delete h['transfer-encoding'];
            res.writeHead(ur.statusCode, h);
            res.end(buf);
          });
        });
        up.on('error', e => { res.writeHead(502); res.end(String(e)); });
        up.end(body);
      });
    }).listen(19502, '127.0.0.1');
    Terminal
    node proxy.js
  3. Register it with Claude Code

    Paste your own token where it says YOUR_TOKEN. Keep the token private, it controls your editor.

    Terminal
    claude mcp add --transport http metapilot-native http://127.0.0.1:19502/mcp \
      --header "Authorization: Bearer YOUR_TOKEN"
  4. Check the connection

    Terminal
    claude mcp list

    You want metapilot-native … ✔ Connected. Then start a Claude Code session and ask it to run appState. It should say whether Edits is on the home screen or in the editor.

Open your project first. Edits shows Claude a different tool set on the home screen than in the editor. In my run the editor tools did not show up in a session that started on the home screen. Open or create the project in Edits, then start a fresh Claude session. If tools look missing, wait about 20 seconds after connecting.

Part 2

Things that tripped me up

Import from the app's folder

Edits is sandboxed and could not read my Desktop or /tmp. Copy the video into ~/Library/Containers/com.burbn.basel.mac/Data/Documents/ and import it from there.

Colour sliders are not 0 to 100

Contrast, vibrance and clarity run from -1 to 1, and saturation from 0 to 2 where 1 is neutral. My first grade maxed everything out and turned the video red and dark. Ask Claude to preview a frame after any grade.

Caption source

Generate captions with the source set to all. Then check that two captions do not repeat a word at the seam. Mine did, and Claude fixed it by editing the caption text.

Text size

Big overlay text wraps onto your face. On a 9:16 video, 28 to 34 pt keeps a short title on one or two lines.

Music library

Downloads from the in-app music library failed for me on every track. Add a royalty-free track yourself, and avoid commercial songs on Instagram.

Claude can delete and export

The tools include delete and export. Say in your prompt that Claude must not export, delete projects or touch other projects unless you ask.

Part 3

Prompting a clean cut

The order Claude worked in is the order that gives the best result: understand the audio, cut, then decorate, then look at the frames. Ask for that order and you avoid most mistakes.

The one-prompt version

Prompt
Use the metapilot-native tools to edit my video in Instagram Edits.

Video: /path/to/my-video.mp4 (vertical 9:16)

1. Check appState. Create a new project and import the video. If the import fails because of the sandbox, copy the file into the Edits app container and import from there.
2. Transcribe it. Find real repeats (retakes, stumbles, the same line said twice) and silent gaps. Keep intentional repetition like lists and punchlines. Cut only what is dead air or a clear retake, leaving about 0.05s around words so it never sounds clipped.
3. Add captions in a bold word-highlight style. Fix any word that repeats at a caption boundary.
4. Add a short hook title in the first 1.5 seconds, keep it to one or two lines, and add a closing line in the last 1.5 seconds.
5. Add punch-in zooms that alternate between normal and about 112% on each cut, a mild colour grade, and a few well-placed effects and whooshes. Keep it tasteful.
6. Render a contact sheet of frames and look at it. Fix anything that looks too dark, too saturated, covered by text or off-centre.
7. Save the project.

Rules: do not export, do not delete anything, do not touch other projects. Tell me what you cut and what you could not check.

Or go one step at a time

Smaller prompts are easier to steer. Each one below works on its own once the clip is on the timeline.

  1. Find what to cut

    Prompt
    Transcribe the clip and find the silent stretches. Show me a list of what you would cut (time range and why) before you change anything.
  2. Make the cuts

    Prompt
    Make those cuts. Split at the edges, delete only the dead pieces, and confirm the track closed up with no gaps. Tell me the new total length.
  3. Captions

    Prompt
    Generate captions from the video audio, use a word-highlight box style with a yellow highlight, and list the caption text so I can check it. Fix any repeated words at caption seams.
  4. Hook and end card

    Prompt
    Add a bold hook title for the first 1.5 seconds near the top of the frame: "YOUR HOOK LINE". Add "FOLLOW FOR PART 2" for the last 1.5 seconds. Keep both on one or two lines and clear of my face.
  5. Energy

    Prompt
    Alternate punch-in zooms (100% and about 112%) on each cut, add a flash or shake on the punchline, add whooshes on the hook and the key beats, and apply a subtle colour grade. Check a frame after the grade and pull it back if it looks harsh.
  6. Look before you finish

    Prompt
    Render a contact sheet at the start, the middle and the end of the edit. Tell me anything that looks wrong, fix it, then save the project. Do not export.

Prompt habits that help

SayWhy
"Keep intentional repetition"Otherwise Claude may treat a list or a punchline as a retake.
"Show me before you change anything"Cuts are quick to approve and slower to undo.
"Check a frame after"Claude can see the result and catch a bad grade or covered face.
"Do not export"You review in Edits and export yourself.
"Tell me what you could not check"Audio quality and timing by ear are still yours to judge.

Part 4

Questions

Does anything leave my computer?

The Edits server and the shim only listen on your own machine. Claude itself still sends your prompts and the tool results (transcripts, project details, small preview images) to Anthropic, like any Claude Code session.

Can I use this on a long video?

I tested it on a 23 second vertical clip. Transcription works in 3-minute pieces, so longer videos should work, but I have not tried one.

Can Claude add b-roll?

Yes, if you give it files. It can overlay screen recordings or images on top of your clip. Give it paths and the lines where each one should appear.

What does this not do well yet?

It does not listen. Judge the audio mix, whoosh timing and caption emphasis yourself, then ask for tweaks.

Rajeev Kugan@rajeevkugan · More creator tools and AI workflows
Follow ↗

Tested on the Edits desktop app for Mac with Claude Code. Menu names and tool names may change between app versions.