GuideInsta Edits for ClaudeIntermediateAbout 10 min5 steps
Let Claude Code edit your Reels inside Instagram Edits for Mac
This guide is for creators and developers comfortable with a terminal. You set up the Insta Edits for Claude plugin so Claude Code can use the full Edits for Mac editor on your Reels.
Before you start
- Use a Mac with Apple silicon (M1 or later).
- Install Edits for Mac (free), sign in to Instagram, and keep the app open while Claude works.
- Install Claude Code.
- Have python3 3.9 or newer; if macOS asks for the command line tools, run xcode-select --install.
In Edits for Mac, go to Edits › Settings › Automation and switch on Enable Automation Server. Copy the Access token, and keep Edits open while Claude works.
Start claude in a terminal, then run the command below inside Claude Code. You run the two install commands one at a time, so stop after this one.
Run in Claude Code /plugin marketplace add faisalkhanzemi/insta-edits-for-claudeRun the second command inside Claude Code. Claude Code asks for the access token with a masked prompt and stores it in your keychain. Paste the token you copied in step 1.
Run in Claude Code /plugin install insta-edits@insta-editsRestart Claude Code, then run /mcp. The plugin also installs the edits skill.
It worked if: In /mcp, edits shows as connected.
Open a project in Edits, then send Claude a request like the example. The bridge tells Claude when Edits moves from the home screen (32 tools) to the editor (274 tools), so the full editor becomes available. The edits skill tells Claude never to publish without your explicit go-ahead.
Paste into Claude In the Edits project I have open, cut the clips on the beat of the music, add captions and transitions, then export the reel. Do not publish anything.
Watch out for
- If you ask Claude to install the plugin in chat, it cannot show the masked token prompt. Run /plugin configure insta-edits@insta-edits and paste the token there, never into the chat.
- Installing from a shell script or from the Claude desktop app does not prompt for the token. Set it afterwards with /plugin configure insta-edits@insta-edits inside Claude Code.
- If Edits is not open yet, the bridge still connects and reports no tools. It tells Claude when Edits answers, so you do not need to restart.
- The error 'Cannot reach Edits: open it and enable the Automation Server' means Edits is closed or the Automation Server is off. A rejected token message explains how to update the token.
- Only Claude Code has been tested. Other MCP clients can run insta-edits serve, but that is untested.
Questions
- Why do I need this instead of pointing Claude Code at Edits directly?
- Edits offers 32 tools on the home screen and 274 once a project is open, but it never sends the tools/list_changed notification. Without the bridge, Claude keeps the 32 home tools all session and never sees the editor.
- Where is my access token stored?
- The plugin keeps the token in the macOS keychain, and the CLI keeps it in a 0600 file. It does not appear in ~/.claude.json, logs or error messages.
- Does it work in the Claude desktop app?
- It works with Claude Code in the terminal and in the Code tab of the Claude desktop app.
- How do I diagnose problems?
- Run the doctor command. It checks every link from the app to the sign-in, and adding --json gives a report you can attach to a bug.