Skip to main content
Tech Provider forFree foreverNo credit cardUnlimited DMsNo watermark
Guides

How to Edit Instagram Reels With Claude AI (Edits Desktop MCP Setup)

Instagram's Edits app for Mac ships a local MCP automation server. Here's how to connect Claude Code to it in one command, what the editor tools actually cover, and the five limits that will break your workflow.

Aman SinghFounder, Creator Lane · Nov 13, 2026
9 min read
Don't feel like reading?

On November 5, 2026, Instagram shipped Edits for Mac. Almost every write-up covered the same things: free, 4K, no watermark, CapCut had better watch out. One line in the announcement got almost no coverage, and it is the most interesting thing in the release:

“And for anyone using AI agents, you can connect them to the desktop editor through MCP so they can help with your projects.”

That is Instagram saying, in a product blog, that an AI agent can drive its video editor. Not generate a video. Edit one — place clips, land cuts, stack overlays, style text, trigger the export. This guide is how to actually set it up, what the server can and cannot do, and where it falls over.

What you need before you start

The gistA Mac with Apple silicon, Edits for desktop, and Claude Code installed locally — the server is loopback-only, so remote Claude can't reach it.

Three requirements, all hard:

  • A Mac with Apple silicon (M1 or later). Edits on desktop is macOS-only. No Windows, no Linux, not even Intel Macs. If you're on a PC, this is the situation.
  • Edits for desktop, free from Instagram, signed in with your Instagram account.
  • Claude Code running on the same machine. The automation server listens on loopback only. Claude in a browser tab cannot reach it; neither can a cloud agent. This has to be local.

Turn on the automation server

The gistSettings → Automation → Enable Automation Server. It starts a local MCP endpoint on port 19501, protected by a bearer token.

Inside Edits, open Settings → Automation and switch on the automation server. The app starts listening on http://127.0.0.1:19501/mcp and shows you a bearer token.

You can confirm it's live from a terminal:

lsof -nP -iTCP:19501 -sTCP:LISTEN

Edits  91109  TCP 127.0.0.1:19501 (LISTEN)

Note the address. 127.0.0.1 means loopback — nothing outside your Mac can connect, and nothing is being sent to Meta by the server itself. That matters for the risk conversation later.

Connect Claude Code in one command

The gistA single `claude mcp add` registers the editor; the tools then load into every session as mcp__edits__* — no config file editing.

The Automation settings page gives you the command. It looks like this:

claude mcp add --transport http --scope user edits \
  http://127.0.0.1:19501/mcp \
  --header "Authorization: Bearer <your-token>"

Run it, start a new Claude Code session, and the editor tools load as mcp__edits__*. That's the whole setup. No JSON config to hand-edit, no Python environment, no scraping library — which makes this the least painful MCP install in the creator space by a distance.

What the tools actually cover

The gistThe server exposes the real editor: a few hundred tools across transitions, effects, filters, LUTs, text, captions, speed curves and fonts — all discoverable at runtime.

Meta publishes no documentation for this server, so the only honest way to describe it is to ask it. Querying a running instance for its capabilities on November 13, 2026 (schema 2026.10.19-1) returns the catalogs the agent can draw from:

Live catalog dump — Edits automation server

Fonts
404
Video effects
148
Filters
77
Text animations
77
Transitions
51
Caption styles
39
Text presets
34
Built-in LUTs
16
Speed curve presets
8

Counts read from a running Edits install, Nov 13 2026. They move with app updates — Instagram ships desktop updates weekly.

The server also tells an agent how to think about the timeline: time in seconds, canvas coordinates normalised 0–1 with the origin top-left, rotation in degrees clockwise, colours as #RRGGBB. It even ships worked recipes — an animated title is addText then applyTextPreset then setTextAnimation; a beat-synced cut is beatMarkers then splitClip.

That last one is the tell. Beat markers plus clip splitting is how you get an agent to cut on the music instead of on a guess.

What a realistic session looks like

The gistYou stage footage, describe the video, and the agent assembles — then you take back the hook and the final watch-through.

The workflow that people are reporting, and the one that matches what the tools are good at:

  1. Stage your media. Edits only reads from its own sandbox directory, so clips and overlay PNGs get copied there first.
  2. Describe the video, not the timeline. What it's about, how long, what the beats are. The agent picks the cuts.
  3. Let it assemble. Overlays at timestamps, sound effects on the beat, a styled title, auto captions in one caption style for the whole video.
  4. Have it check its own work. The server can return preview frames, so the agent can look at the frame it just built before you do.
  5. You finish it. Open the project, fix the hook, watch it start to finish, export.

Nate Curtiss, who runs a YouTube agency, put the division of labour better than anyone: “keep 2 parts for yourself: the hook — the first 5 seconds decide whether anyone watches the rest. the final review — watch it start to finish before it goes out.”

He's right, and the reason is structural. An agent optimises the assembly, which is the boring, mechanical, hour-of-clicking part. It has no idea whether your first five seconds earn attention, because that is a judgement about your audience that lives in your head.

The five limits that will bite you

The gistSandboxed file reads, a 60-second licensed-music cap, missing keyframe types, no text line-height, and an export that fails silently unless three parameters are set together.
Known rough edges
  • Sandboxed media. The app only reads files inside its own container directory. Anything the agent places has to be staged there first.
  • Licensed music caps at 60 seconds. Longer videos lose the track on export or share unless the song is trimmed.
  • No opacity or blur keyframes. Fades on those properties have to be faked or done by hand.
  • No text line-height control, and no single background box behind multi-line text. Stacked lines need manual spacing.
  • Export fails silently. Resolution type, aspect ratio and quality must all be set together, or the export simply never starts and nothing tells you why.

These come from community field notes on the undocumented server, not from Meta. Re-check them against your own install — the tool surface changes with weekly updates.

It cannot post, and that is the point

The gistNo posting, no trial reels, no scheduling through the server — which is exactly why it carries none of the account risk that scraping-based Instagram MCPs do.

The automation server does not publish. No posting, no trial reels, no scheduling. You export and share from the Edits UI yourself.

People read that as a missing feature. It is the best thing about it. We've written before about how most Instagram MCPs are a ban risk wearing a product costume — the viral ones run on unofficial scraping libraries and ask for your raw Instagram password, which is the single most reliable way to lose an account.

Why this one is different

The Edits server never sees your password, never calls the Graph API, and never touches your account. It drives a local application window on your own machine. The blast radius of a mistake is a bad edit, not a suspended profile.

Where the automation actually ends

The gistThe agent stops at the export. Publishing is manual, and the follow-up after the post is a completely separate system.

Worth being clear-eyed about what you have and haven't automated here. Editing: yes, the assembly half of it. Publishing: no, by design. And the part that decides whether the reel earns anything — replying to everyone who comments asking for the link — is not something a video editor can touch at all.

That gap gets wider the better this works. Ship three times the reels and you get three times the comments. The follow-through is its own system, built on Instagram's official API, and it is the half that most people skip.

Should you bother?

The gistIf you film your own videos, post weekly, and have no editor, the rough cut just became free. If you already have an editor, this is a toy.

Honest answer: it depends entirely on whether assembly is your bottleneck.

If you film your own content, post regularly, and lose an hour per reel to clicking overlays into place, this removes most of that hour. If you already work with an editor, or you only post occasionally, the setup cost is not worth it yet — the tooling is eight days old, undocumented, and changes weekly.

What's not in doubt is the direction. An Instagram product now ships an agent interface to its own timeline. That is a fairly loud signal about where the editing stack is heading, and it is worth an afternoon to understand before everyone else does. For the parts you still do by hand, our Instagram Edits help guides cover the manual workflows.

Frequently asked

Can Claude actually edit my Instagram Reels?
Yes, on a Mac. Instagram's Edits desktop app exposes a local MCP automation server under Settings → Automation. Any MCP client — Claude Code included — can connect to it and place clips, overlays, sound effects, text and captions on the timeline, then trigger an export.
Does Instagram Edits have a public API?
No. There is no public, documented API. What exists is a local automation server inside the Mac app, intended for AI agents, and Meta has not published documentation for it. Treat any tool list you find as community field notes that can change with an app update.
Can Claude post the reel to Instagram when it's done?
Not through the automation server. Posting, trial reels and scheduling are not exposed to it — you publish from the Edits share sheet yourself. If you want the distribution automated after the post goes live, that is a comment-to-DM job, not an editing job.
Will this get my Instagram account banned?
The Edits automation server never sees your password and never touches the Graph API — it only drives a local editor window. That is a different risk class from the password-grabbing Instagram MCPs built on unofficial scraping libraries, which do get accounts banned.
Does it work on Windows or iPhone?
No. The automation server exists only in Edits for Mac, and Edits on desktop is macOS-only, Apple silicon (M1 or later).