
insta-edits
Let Claude edit your Instagram Reels in Edits for Mac: cut to the beat, captions, text, transitions, zooms and export, with the full 274-tool editor. Keeps Claude's tool list in sync and your token in the keychain.
- GitHub stars
- 23
Install
/plugin install insta-edits@insta-editsRun it inside Claude Code after adding the marketplace with /plugin marketplace add faisalkhanzemi/insta-edits-for-claude.
Contents
Discovered from sourceSkills 1
Working in Instagram Edits through the edits tools
The edits MCP server is Edits for Mac's own automation server, reached through the Insta Edits for Claude bridge (insta-edits).
It is undocumented and updated weekly, so treat the live tool list and getCapabilities as the source of truth over anything below.
Before the first call
- If a call fails with "Cannot reach Edits", Edits is closed or its server is off: ask the user to open Edits and turn on Settings > Automation > Enable Automation Server.
- If
edits_statusis the only tool listed, Edits isn't reachable: call it, pass its message on to the user, and call it again once they say Edits is open. When it connects, Edits' own tools replace it. - If it fails with HTTP 401/403, the token changed in Edits. Ask the user to update it in
/plugin(or runinsta-edits set-token). Never ask them to paste the token into the chat. insta-edits doctorin a terminal checks every link and is the first thing to run when something is off.
How the server behaves
- The tool list follows the screen. About 30 tools on the home screen (projects, import, catalogs); the editing tools appear once a project is open. Call
appStateto see the screen, thenprojectsandopenProject(ornewProject). Edits never announces the change itself; the bridge checks after each call and tells Claude, so the new tools show up without reconnecting. If they don't, calltools/listagain or check thateditsruns through the bridge. - Discover, don't guess.
getCapabilitiesreturns conventions, catalogs and recipes.listCatalogKinds,listCatalogandgetCatalogItemsay which value eachapply…tool accepts (effects, filters, LUTs, transitions, text animations and presets, caption styles, fonts, speed curves, masks). Speed curves: apply them withsetSpeedCurve(id,preset), using the ids fromlistSpeedCurvePresets. Edits' own catalog namesselectSpeedPanelPreset, a tool whose description says it is deprecated, refused and crashed the app; the bridge rewrites that entry tosetSpeedCurve, but if you ever see the old name, don't callselectSpeedPanelPresetordragSpeedPanelCurve. - Conventions: time is seconds on the composition timeline; the canvas is normalised 0-1 from the top-left with x/y at the element's centre; colours are
#RRGGBBor#RRGGBBAA; rotation is degrees clockwise. - Edits is sandboxed.
Sandbox bookmark unavailablemeans Edits may not read that folder.~/Moviesworks;~/Downloads,~/Desktop, temp folders and project folders do not. Copy the footage into~/Moviesfirst, and export into~/Moviestoo. You cannot write into Edits' own container either: macOS blocks it. - Paths must be absolute. Edits doesn't expand
~: pass/Users/<name>/Movies/.... - Check your work with rendered frames.
captureFrame(withatSecondsortimes) is the quick check. UsepreviewVideo, thenpreviewVideoStatus/previewVideoFrames, for a full render rather than screenshots of the app window. - New projects start in HDR. Phone footage looks fine, but screen recordings of the preview blow out to white. Call
setProjectDynamicRangewithSDRwhen the user is recording the screen or delivering SDR. - Beats:
beatMarkerscan return zero beats on the user's own music at anysetBeatDensity. Fall back toaudioOnsetson the music element, read the pulse from the onsets, and place markers withaddBeatMarkerbefore trimming clips onto them. - Keyframes:
setTransformKeyframestakes a JSON array where every keyframe hastime,x,yandscale. ReadgetTransformfirst and keep x/y unless you mean to move the clip. - Export:
exportrefuses until a complete preset exists. CallsetExportSettingsfirst withresolutionType(720p,HD,2Kor4K),aspectRatio(such asnineBySixteen),frameRate,qualityanddynamicRange, thenexportand pollexportStatusuntil it reports complete.
Rules for the user's account
- Never publish, share or schedule anything without the user's explicit go-ahead for that specific post. Edits signs in to the user's Instagram account. The automation server has no tool that posts, shares or schedules: posting happens in Edits' own share screen, so hand that step to the user.
- Ask before deleting a project (
deleteProject); preferduplicateProjectto experiment. - Library songs do not survive an automation export. Songs added with
addSongToCompositioncome in as licensed, even ones the catalog lists as royalty-free, andexportwrites silence where they play. The user's own audio files (addMediawithaudioKind) export fine. When a library song matters, leave the final export or post to the Edits window, and say so. - Add a library song by its exact title: passing a track id sometimes adds a different song. Check the result with
elements.
MCP servers 1
Sponsors
Details
- Marketplace
- faisalkhanzemi/insta-edits-for-claude
- Category
- Media