@makeaivideo/cli
Advanced tools
MakeAIVideo CLI: make AI videos from your terminal with the MakeAIVideo AI video generator. Brief in, finished MP4 out (voiceover, scenes, captions, music), then post it to TikTok, Instagram, YouTube and more. JSON output for AI agents and CI.
@makeaivideo/cli)
The MakeAIVideo CLI makes AI videos from your terminal: give it a brief or a script and it returns a finished MP4 with AI voiceover, AI or stock scenes, captions and music, then posts or schedules it to your connected TikTok, Instagram, YouTube and other social accounts.
MakeAIVideo is an AI video generator for short-form video. This CLI is a thin client for its REST API (CLI guide).
npx @makeaivideo/cli login
makeaivideo tools
makeaivideo create explainer --topic "Why planes leave white trails" --wait --out trails.mp4
makeaivideo publish <video_id> --accounts acc_123 --caption "Why planes leave white trails"
Zero runtime dependencies (Node 18+). Every command prints JSON with --json (automatic when
piped), so it works as a tool for Claude, Cursor and CI as well as for people.
npm i -g @makeaivideo/cli # or just use npx @makeaivideo/cli
makeaivideo login opens app.makeaivideo.ai, you confirm a short code, and a scoped API key is
saved to ~/.makeaivideo/config.json (mode 600). Revoke it any time under Settings, Advanced,
API keys.
Headless environments skip login: export MAKEAIVIDEO_API_KEY=mav_....
Every command prints JSON. Ids are the public ids the API returns (vid_…, wh_…).
| Area | Commands |
|---|---|
| Account | login, logout, whoami, credits, workspace [--name --aspect --style] |
| Make a video | tools, estimate <tool>, create <tool> --<field> … (--duration --aspect --language --draft --wait --out --idempotency-key), create --script f.json [--mode --voice-id --music-id --character-id] |
| Scripts | script --topic "…" or script --tool explainer --field-topic "…", scriptify <file.txt>, fetch-url <url> |
| Track and fetch | videos, status <id>, wait <id> [--out f], download <id> [--out f], captions <id> [--format vtt] [--out f], share <id> [--expires s] |
| Edit and redo | update <id> [--title --topic --script f.json --caption-style], generate <id>, scene-regen <id> <n> [--narration], voice <id> --voice-id v, export <id>, renders <id>, render-progress <id> |
| Manage | cancel <id>, delete <id>, report <id> --reason "…" |
| Ideas | ideas --niche "…" [--audience --tone --count], enhance --topic "…" |
| Characters | characters, character <id>, portraits --prompt "…" --style s, voice-previews, character-create --name --style --portrait --voice-preview --voice-id, character-delete <id> |
| Assets | upload <image…>, upload-url <image_url>, voices, voice-preview <id> [--text], music, music-generate --prompt "…", brand-kit [--show true], brand-kit-watermark <png>, templates |
| Post to social | accounts, connect <platform>, publish <id> --accounts acc_1,acc_2 --caption "…" [--schedule <ISO-8601> --timezone --youtube-title --idempotency-key], posts [--video <id>], post <post_id> |
| Webhooks | webhooks, webhook-add <url> --events video.ready,video.failed, webhook-test <id>, webhook-deliveries <id>, webhook-enable <id>, webhook-rm <id> |
Set --idempotency-key <key> on create so a retried command never makes (and charges for) a
second video. The same flag on publish stops a retry from posting twice.
makeaivideo accounts # connected accounts and their acc_... ids
makeaivideo connect tiktok # prints a link: open it in a browser to connect
makeaivideo publish vid_abc --accounts acc_1,acc_2 --caption "New video" --schedule 2026-10-01T09:00:00Z
makeaivideo post <post_id> # status and per-platform results
TikTok, Instagram (as a Reel), YouTube (9:16 as a Short), Facebook Pages, LinkedIn, Threads and Pinterest connect by link. Bluesky, Telegram and Discord connect in the web app. X is not supported. More at makeaivideo.ai/auto-post.
This package ships a Claude Code plugin (.claude-plugin/plugin.json + SKILL.md) and an
.mcp.json pointing at the hosted MCP server https://mcp.makeaivideo.ai. In
Claude.ai, ChatGPT or Cursor, add that URL as a custom connector and approve access in the
browser; no key to paste.
REST API spec: https://app.makeaivideo.ai/api/v1/openapi.json.
MAKEAIVIDEO_API_KEY overrides the saved login.MAKEAIVIDEO_API_URL points at another host (default https://app.makeaivideo.ai).What is the MakeAIVideo CLI? An MIT-licensed command line client for the MakeAIVideo AI video generator. It creates finished short-form videos from a brief or script, downloads the MP4, and posts it to connected social accounts.
How do I install it? npm i -g @makeaivideo/cli, or run it without installing via npx @makeaivideo/cli. Node 18 or newer.
Can Claude Code or another AI agent use it? Yes. Every command prints JSON, and the package ships a Claude Code plugin (SKILL.md) plus an .mcp.json for the hosted MCP server https://mcp.makeaivideo.ai.
Which platforms can it post to? TikTok, Instagram, YouTube, Facebook Pages, LinkedIn, Threads, Pinterest, Bluesky, Telegram and Discord. X is not supported.
How is it priced? MakeAIVideo is a paid product with monthly plans and a 7-day trial (card required). The CLI uses the same credits as the app; estimate quotes a video before you create it. See pricing.
Where do I get help? Open an issue or email support@makeaivideo.ai.
https://mcp.makeaivideo.ai (setup guide)MakeAIVideo is an AI video generator that turns a brief, a prompt, your own script, an image or a talking avatar into a finished, captioned short-form video: script, AI voiceover, AI-generated or stock scenes, captions and music, exported as an MP4 ready for TikTok, Instagram Reels and YouTube Shorts. It also does character swap, and posts or schedules videos to connected TikTok, Instagram, YouTube, Facebook Pages, LinkedIn, Threads, Pinterest, Bluesky, Telegram and Discord accounts. Operated by MintClips Ltd (UK).
| Package | What it is |
|---|---|
@makeaivideo/sdk | TypeScript / JavaScript SDK for the REST API |
@makeaivideo/mcp | MCP server for Claude, ChatGPT, Cursor and other AI assistants |
@makeaivideo/cli | Command line tool: brief in, MP4 out |
MIT © MakeAIVideo
FAQs
MakeAIVideo CLI: make AI videos from your terminal with the MakeAIVideo AI video generator. Brief in, finished MP4 out (voiceover, scenes, captions, music), then post it to TikTok, Instagram, YouTube and more. JSON output for AI agents and CI.
The npm package @makeaivideo/cli receives a total of 107 weekly downloads. As such, @makeaivideo/cli popularity was classified as not popular.
We found that @makeaivideo/cli demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Research
/Security News
Tensorlake npm SDK version 0.5.144 was compromised in a ChainDrop / Shai-Hulud attack, delivering credential-stealing malware.
Research
/Security News
Socket found 16 malicious Firefox extensions designed to steal crypto wallet recovery phrases and private keys using cloned Rabby and OKX interfaces.
Product
Socket now scans VS Code extensions, giving teams early detection of risky behaviors, hidden capabilities, and supply chain threats in developer tools.