video-mcp

Sort the shoot.
Keep the good takes.

Point it at a folder of raw clips. It splits A-roll from B-roll, groups everything by topic, and pulls the flubbed takes, lens-cap clips and near-duplicates into _rejects, judged by the Claude, Codex or Grok CLI you're already signed in to.

curl -fsSL https://raw.githubusercontent.com/neelsatyavolu/videomcp/main/install.sh | bash
Download for Mac

Unzip, then double-click Install video-mcp.command. If macOS can't verify the developer, go to System Settings → Privacy & Security and click Open Anyway.

raw/8 clips
  1. intro_take2.mp400:00:05:02Desk Lamp Setup/a-roll
  2. intro_take1.mp400:00:06:04_rejects · restarted line
  3. coffee_talk.mp400:00:05:25Coffee/a-roll
  4. grinder_closeup.mp400:00:06:00Coffee/b-roll
  5. grinder_closeup_2.mp400:00:06:00_rejects · near-duplicate
  6. lamp_unbox.mp400:00:12:10Desk Lamp Setup/b-roll
  7. IMG_0412.MOV00:00:04:00_rejects · mostly black
  8. IMG_0413.MOV00:00:00:15_rejects · too short

How it works

  1. 01

    Look

    Every clip is checked on your Mac: speech-to-text, keyframes, on-screen text, and ffmpeg measurements for focus, exposure, shake, clipped audio, silence and black frames.

  2. 02

    Judge

    Your signed-in agent CLI sees the transcript, the measurements and a few keyframes, and says keep or reject. Then it names the topics and picks the best of repeated takes.

  3. 03

    File

    Clips move into Topic/a-roll, Topic/b-roll or _rejects, with a footage-report.md explaining each call. Files are never overwritten or deleted.

Use it

# see the plan, move nothing
video-mcp sort ~/Footage/shoot --dry-run

# sort (asks before moving)
video-mcp sort ~/Footage/shoot

# put everything from the last run back
video-mcp sort --undo ~/Footage/shoot