Claude Code
Make and edit videos with Claude, using the Miraiclip plugin.
Coming in the next release
The plugin is built and tested, and ships with the next SDK release. It needs @miraiclip/mcp 0.1.4 or later, which is not on npm yet.
The Miraiclip plugin for Claude Code bundles the MCP server with skills that teach Claude how to edit well: pacing, type, motion, captions, and a review pass where it looks at its own frames before exporting.
claude plugin marketplace add comaniacs/miraiclip
claude plugin install miraiclip@miraiclipThen make a folder for the video, put the media in it, and start Claude Code there:
mkdir launch-video && cd launch-video
# copy in footage, screenshots, logo, music…
claude> Make a 30-second 16:9 launch video for our 2.0 release from notes.md and the screenshots in this folder.What you need
| Requirement | Why |
|---|---|
| Node.js 18+ | Runs the MCP server and helper scripts |
| Google Chrome | Frame previews and MP4 export. Any Chromium works for WebM; set MIRAICLIP_BROWSER to its path |
| ffmpeg (with ffprobe) | Reading media durations, silence detection, contact sheets |
faster-whisper or openai-whisper (optional) | Automatic transcripts for captions and talking-head cuts |
Skills
Claude picks the skill from the request. You can also name it.
| Skill | Use it for |
|---|---|
edit-video | Any edit, and choosing a workflow. Holds the shared rules and the craft reference |
talking-head | Interviews, podcasts, tutorials: cut pauses and filler words, punch-ins, karaoke captions, lower third |
captions | Captions on any video, five tested styles, SRT/VTT sidecar files |
launch-video | Product launches and explainers from a brief, screenshots and a logo, as HTML motion graphics |
reformat | 16:9 ↔ 9:16, 1:1, 4:5 versions and social cut-downs |
screen-tutorial | Screen recordings into tutorials and walkthroughs: zoom on the action, speed up waiting, hold frames, blur private data, step callouts and chapters |
make-template | Reusable themed templates with a form of fields, in four themes and 16:9 + 9:16, checked frame by frame in the React studio |
How Claude works on a video
- Reads the project (
get_state) and registers your media with real durations. - Writes a short plan (for launch videos, a scene list).
- Applies the plan as one
apply_commandsbatch, so it undoes as one step. - Looks at the result:
preview_framefor single moments, and a contact sheet of a draft export for motion and pacing. - Fixes what it sees, then exports.
Everything Claude does is a normal Miraiclip command saved in video.miraiclip.json, so you can open the same project in an editor built on Miraiclip and keep editing by hand.
One folder, one video
The plugin's server edits ./video.miraiclip.json in the folder Claude Code starts in, and media paths resolve against that folder. Start Claude Code in a different folder for each video.
| Variable | Default | What it changes |
|---|---|---|
MIRAICLIP_PROJECT | video.miraiclip.json | Project file |
MIRAICLIP_ASSETS | the project file's folder | Base folder for media paths |
MIRAICLIP_BROWSER | installed Google Chrome | Chrome or Chromium binary |
MIRAICLIP_MCP | @miraiclip/mcp@^0.1.4 | npm spec of the server, or a path to a local cli.js build |
Helper CLI
The skills call scripts/mc.mjs in the plugin. It prints commands for Claude to apply and never writes the project itself.
| Command | What it does |
|---|---|
probe <files…> | asset/add commands with duration, size and fps (ffprobe) |
transcribe <media> | Word timestamps with faster-whisper or openai-whisper |
cuts <media> --words w.json | Ranges to keep after removing silences and filler words |
recut --asset id --keep k.json | Back-to-back clips for the kept ranges, plus a source → timeline map |
captions <words|srt|vtt> | Caption clips, grouped and styled, remapped through a recut |
animate --clip id --in pop | The editor's animation presets as keyframes |
sheet <video> | A contact sheet image, one frame per interval, for review |
subtitles --format srt | SRT, VTT or plain text from the project's caption clips |
Without the plugin
Any MCP client can use the server alone; see MCP server. You get the tools without the skills.