Insta Edits for Claude Code — Claude Code MCP server: what it does
Insta Edits for Claude — an MCP server for Claude Code bridges the model with Instagram Edits for Mac. It refreshes editor controls as you navigate between home catalogs and active timelines.
MIT ★ 27 updated 2026-11-11
claude mcp add --env EDITS_MCP_TOKEN=<EDITS_MCP_TOKEN> --env EDITS_MCP_URL=<EDITS_MCP_URL> --transport stdio insta-edits-for-claude -- uvx insta-editsWhat Insta Edits for Claude does
The server links Claude Code to the local automation interface running inside Edits for Mac at 127.0.0.1:19501. On its home screen, Edits exposes 32 tools, expanding to 274 once a project opens. Edits omits the notification that announces this change, leaving AI clients locked to the initial 32 actions. This bridge polls the toolset after every call and emits notifications/tools/list_changed whenever the catalog expands.
It cleans up response payloads where caching parameters are missing, preventing tool drops in newer MCP client builds. Deprecated preset calls through selectSpeedPanelPreset are mapped directly to setSpeedCurve so speed ramp adjustments avoid crashes.
Execution requires an Apple silicon Mac (M1 or newer), the official Edits desktop app with the automation server turned on, and Python 3.9+. The bridge places your access credentials into the macOS keychain or a 0600 permission file rather than unencrypted configuration files.
What it helps with
- unlock all 274 editing tools instead of the initial 32 home actions
- cut timeline video clips to match audio tempo markers
- apply speed ramp presets without triggering desktop app crashes
- inspect rendered output frames directly from the session
Example prompts for the agent
- Open the project in Edits and cut clips to match the 122 BPM audio track
- Inspect the rendered frames and position text overlays on the timeline
- Apply a speed curve preset to the active video clip
How to install Insta Edits for Claude
Platform CLI
claude mcp add --env EDITS_MCP_TOKEN=<EDITS_MCP_TOKEN> --env EDITS_MCP_URL=<EDITS_MCP_URL> --transport stdio insta-edits-for-claude -- uvx insta-editsReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from insta-edits <command>
Platform CLI
codex mcp add insta-edits-for-claude --env EDITS_MCP_TOKEN=<EDITS_MCP_TOKEN> --env EDITS_MCP_URL=<EDITS_MCP_URL> -- uvx insta-editsReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from insta-edits <command>
Config file
{
"mcpServers": {
"insta-edits-for-claude": {
"command": "uvx",
"args": [
"insta-edits"
],
"env": {
"EDITS_MCP_TOKEN": "<EDITS_MCP_TOKEN>",
"EDITS_MCP_URL": "<EDITS_MCP_URL>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from insta-edits <command>
Config file
{
"servers": {
"insta-edits-for-claude": {
"type": "stdio",
"command": "uvx",
"args": [
"insta-edits"
],
"env": {
"EDITS_MCP_TOKEN": "<EDITS_MCP_TOKEN>",
"EDITS_MCP_URL": "<EDITS_MCP_URL>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from insta-edits <command>
Platform CLI
gemini mcp add -e EDITS_MCP_TOKEN=<EDITS_MCP_TOKEN> -e EDITS_MCP_URL=<EDITS_MCP_URL> insta-edits-for-claude uvx insta-editsReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from insta-edits <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Insta Edits for Claude
How to install Insta Edits for Claude in Claude Code?
Run claude mcp add insta-edits -e EDITS_MCP_TOKEN=<EDITS_MCP_TOKEN> -- uvx insta-edits with your token from Edits settings.
Why is this bridge required instead of connecting directly?
Edits fails to fire the tool change notification when switching views. The bridge checks the state after each command and tells Claude to refresh its 274-tool suite.
What is required to run Insta Edits for Claude Code?
An Apple silicon Mac (M1 or newer), Edits for Mac with Automation Server enabled, Claude Code, and Python 3.9 or newer.