reelsdk-mcp

Let your coding agent edit video: TikTok-style captions, photo slideshows with voiceover, AI-generated shorts and any ffmpeg command, rendered in the cloud and saved straight into your project. No ffmpeg, whisper or GPU on your machine.

> add TikTok captions to ./clip.mp4
> turn the 8 photos in ./trip into a 30 s slideshow with a voiceover and ./song.mp3 underneath
> make a 45 s short about the Mary Celeste in the dark-documentary style
> crop ./demo.mp4 to 9:16 for Reels

The agent calls a tool, local files are uploaded, the job runs on reelsdk, and the finished files land in ./reelsdk-output.

Setup

You need Node 20+ and a reelsdk API key (rsdk_live_...).

Claude Code

claude mcp add reelsdk --env REELSDK_KEY=rsdk_live_xxx -- npx -y github:bitgate/reelsdk-mcp

Add --scope project to share it with your team through .mcp.json.

Cursor

.cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project):

{
  "mcpServers": {
    "reelsdk": {
      "command": "npx",
      "args": ["-y", "github:bitgate/reelsdk-mcp"],
      "env": { "REELSDK_KEY": "rsdk_live_xxx" }
    }
  }
}

Claude Desktop

Settings → Developer → Edit Config (claude_desktop_config.json). Desktop has no project folder, so pass absolute paths and pick where results go:

{
  "mcpServers": {
    "reelsdk": {
      "command": "npx",
      "args": ["-y", "github:bitgate/reelsdk-mcp"],
      "env": { "REELSDK_KEY": "rsdk_live_xxx", "REELSDK_OUTPUT_DIR": "~/Movies/reelsdk" }
    }
  }
}

VS Code

.vscode/mcp.json (asks for the key once and stores it encrypted):

{
  "inputs": [{ "type": "promptString", "id": "reelsdk-key", "description": "reelsdk API key", "password": true }],
  "servers": {
    "reelsdk": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:bitgate/reelsdk-mcp"],
      "env": { "REELSDK_KEY": "${input:reelsdk-key}" }
    }
  }
}

Windsurf

Settings → Cascade → MCP Servers → View raw config, then add the same mcpServers entry as Cursor.

Related MCP server: Lazynext MCP Server

Tools

Every media argument takes a local path (absolute or relative to the project) or a public http(s) URL. Results are never overwritten (clip-captioned-2.mp4), and subtitle files go into reelsdk-output/captions/ so players don't stack them on top of the burned-in captions.

Tools wait up to REELSDK_WAIT_S seconds, sending progress updates if your client shows them. A job that takes longer comes back as a job_id, and the agent calls get_job to pick it up.

Configuration

The project root is CLAUDE_PROJECT_DIR when Claude Code sets it, else the client's first workspace root, else the directory the server was started in.

Limits

Local files up to 100 MB (pass a public URL for bigger inputs, up to 500 MB). Up to 15 minutes of media and 10 minutes of processing per job.

Development

npm ci
npm test            # unit + tool tests against a fake API
npm run typecheck
npm run bundle      # rebuilds dist/index.js, which is committed

dist/ is committed so npx github:bitgate/reelsdk-mcp starts without a build step. See AGENTS.md.

License

MIT