# Insta Edits for Claude

> Insta Edits for Claude is an open-source MCP server for ai models and llm tooling. Let Claude Code drive the full Instagram Edits for Mac video editor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/faisalkhanzemi/insta-edits-for-claude
- **MCP Registry name:** io.github.faisalkhanzemi/insta-edits
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm), [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

Edits for Mac changes its tool list depending on the screen: 32 tools on the home screen for projects, imports and catalogs, and 274 once a project is open, covering text, captions, effects, transitions, keyframes, audio and export. The README says Edits announces the change but never sends the notification, so Claude Code would otherwise stay stuck with the home tools.

This bridge asks Edits for its tool list after every call and tells Claude when it changes, so the editor appears without a restart. It also removes a reply marker that some Claude Code builds reject, replaces stack traces with actionable errors, and redirects the deprecated speed-curve preset tool to setSpeedCurve. The access token from Edits > Settings > Automation is stored in the macOS keychain or a 0600 file rather than in config files.

Requirements are an Apple silicon Mac, Edits for Mac signed in to Instagram, Claude Code and python3 3.9 or newer; it uses only the Python standard library. Only Claude Code has been tested. An `insta-edits doctor` command checks each link, and a bundled skill tells Claude to check rendered frames and never publish without your go-ahead.

## Features

- **Full editor access:** Switches between the 32 home tools and the 274 editor tools automatically.
- **Reply format fix:** Removes a result marker that made some Claude Code builds drop all tools.
- **Speed-curve workaround:** Points deprecated preset calls at setSpeedCurve.
- **Private token storage:** Keeps the access token in the keychain or a 0600 file.
- **Doctor command:** Checks the app, token, sign-in and tool set, with JSON output.
- **Edits skill:** Teaches Claude to discover tools first and not publish without approval.

## Good for

- Cut a reel on the beat of its music
- Add captions and effects through a prompt
- Check rendered frames before exporting
- Diagnose why Claude cannot see the editor tools

## Install

### Claude Code (Terminal)

```sh
claude mcp add insta-edits --env EDITS_MCP_TOKEN='<EDITS_MCP_TOKEN>' -- uvx insta-edits
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "insta-edits": {
      "command": "uvx",
      "args": [
        "insta-edits"
      ],
      "env": {
        "EDITS_MCP_TOKEN": "<EDITS_MCP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "insta-edits": {
      "command": "uvx",
      "args": [
        "insta-edits"
      ],
      "env": {
        "EDITS_MCP_TOKEN": "<EDITS_MCP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "insta-edits": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "insta-edits"
      ],
      "env": {
        "EDITS_MCP_TOKEN": "<EDITS_MCP_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "insta-edits": {
      "command": "uvx",
      "args": [
        "insta-edits"
      ],
      "env": {
        "EDITS_MCP_TOKEN": "<EDITS_MCP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "insta-edits": {
      "command": "uvx",
      "args": [
        "insta-edits"
      ],
      "env": {
        "EDITS_MCP_TOKEN": "<EDITS_MCP_TOKEN>"
      }
    }
  }
}
```

## FAQ

### What do I need?

An Apple silicon Mac, Edits for Mac signed in to Instagram, Claude Code and python3 3.9+.

### Where does the token come from?

Edits > Settings > Automation, then Enable Automation Server.

### Is it tested with other clients?

Only Claude Code; other stdio MCP clients may work.

### Does it install Python packages?

No. It uses the Python standard library only.

### Is Insta Edits for Claude free?

Yes. Insta Edits for Claude is open source, so you can use and self-host it for free.

### How do I add Insta Edits for Claude to Claude Code?

Run this command in your terminal: claude mcp add insta-edits --env EDITS_MCP_TOKEN='<EDITS_MCP_TOKEN>' -- uvx insta-edits

### What are the best alternatives to Insta Edits for Claude?

The closest alternatives to Insta Edits for Claude are HyperFrames by HeyGen, headroom, omniget, next-ai-draw-io and mcp-for-blender.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [headroom](https://ai-powered.com/mcp/headroom-3): headroom is an open-source MCP server for ai models and llm tooling.
- [omniget](https://ai-powered.com/mcp/omniget): omniget is an open-source MCP server for ai models and llm tooling.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [unity-mcp](https://ai-powered.com/mcp/unity-mcp-2): unity-mcp is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/insta-edits-for-claude
