mmx-cli skill: let Claude generate images, video and speech with MiniMax

Lets Claude use the MiniMax command line tool to make text, images, video and speech, and to transcribe audio.

Installs: 32.3K; on skills.sh
Stars: 2.2K; on GitHub
Updated: Oct 2026; last repo commit

mmx-cli teaches Claude how to drive the mmx command line tool for the MiniMax AI platform. Claude can chat with MiniMax models, generate images, video and speech, transcribe audio, describe an image and run a web search.

The skill does not include mmx. You install the tool with npm and sign in with MiniMax OAuth or an API key first. The calls use your MiniMax quota, and your prompts and files go to MiniMax.

Good for

Developers who want Claude to make media from the terminal
Content teams generating images, voice-overs and short videos in bulk
MiniMax Token Plan users who want one tool for text, image, video and speech

Install mmx-cli

Claude Code

Copy this prompt.

Install the mmx-cli skill in Claude Code. Run this command:

npx skills add MiniMax-AI/cli -y -g

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18+, MiniMax Token Plan or API key.

The skill is only instructions for the mmx command, so the tool and a login come first. The README says the CLI requires a MiniMax Token Plan; SKILL.md says a pay-as-you-go key works with --model MiniMax-M3.

From the project README. Source.

What's in the skill

When it loads

Use mmx to generate text, images, video, and speech, and to transcribe audio, via the MiniMax AI platform. Use when the user wants to create media content, chat with MiniMax models, transcribe audio to text, perform web search, or manage MiniMax API resources from the terminal.

Sections in SKILL.md

Prerequisites
Agent Flags
Commands
text chat
image generate
video generate
video task get
video download
speech synthesize
speech transcribe
vision describe
search query
quota show
Tool Schema Export
Exit Codes
Piping Patterns

Key facts

Author: MiniMax-AI
Repo: minimax-ai/cli
Installs on skills.sh: 32,266 as of Nov 2, 2026
GitHub stars: 2,209 for the whole minimax-ai/cli repo, Nov 2, 2026
Last repo commit: Oct 19, 2026
What is inside: 3 files including SKILL.md: a second skill file for MiniMax-H3 video (h3-video/SKILL.md) and its reference
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn
License: MIT (README)
Needs: The mmx command line tool (npm install -g mmx-cli, Node.js 18+) and a MiniMax login or API key
Plan: The README header says it requires a MiniMax Token Plan, but the same README says the default text model also works with pay-as-you-go keys. SKILL.md says that model needs M Plan or MiniMax Code and pay-as-you-go keys use --model MiniMax-M3. The files disagree.

What it includes

Chat with MiniMax models from the terminal
Default model MiniMax-M3.1-Flash. Thinking is on by default.
Try: “Ask MiniMax to summarise this paragraph.”
Network · mmx text chat
Generate images with image-01 and save them to a folder
Flags include --aspect-ratio, --n, --out-dir and --subject-ref.
Try: “Generate three logo options and save them to ./gen.”
Write · mmx image generate
Generate video; waits for the result or returns a task ID
Default model MiniMax-Hailuo-2.3. MiniMax-H3 has its own skill file.
Try: “Make a 6 second video of ocean waves and save it as ocean.mp4.”
Write · mmx video generate
Check a video job and download the finished file
mmx video task get / download
Text to speech, up to 10k characters, saved as mp3 by default
Try: “Read this paragraph aloud and save hello.mp3.”
Write · mmx speech synthesize
Speech to text for audio files up to 50 MB and 500 seconds
Accepts wav, aiff, flac, m4a, mp3, aac, opus and ogg.
Try: “Transcribe meeting.mp3 with word timestamps.”
Files · mmx speech transcribe
Describe an image from a path, URL or uploaded file ID
Try: “What breed is the dog in photo.jpg?”
Files · mmx vision describe
Web search through MiniMax
Try: “Search MiniMax for news about its latest model.”
Network · mmx search query
Show Token Plan usage and remaining quota
Network · mmx quota show
--non-interactive, --quiet, --output json, --async, --dry-run, --yes
The skill tells agents to use these in non-interactive runs. --dry-run previews the request without sending it.
Agent flags
Export the commands as JSON tool schemas
Read · mmx config export-schema
mmx auth login saves a key or OAuth login; config lives in ~/.mmx
OAuth is saved to ~/.mmx/credentials.json and an API key to ~/.mmx/config.json.
Write · Auth and config

From the official docs

Permissions

Medium risk

Claude runs a tool that spends your MiniMax quota and uploads prompts, images and audio to MiniMax. Check your quota and keep the saved key out of shared folders.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It spends your MiniMax quota
Generation calls use Token Plan quota or pay-as-you-go balance. Run mmx quota show before big jobs and use --dry-run to preview a request. github.com
Your files and prompts go to MiniMax
Prompts, images for vision describe and audio for transcription are sent to the MiniMax API. Do not point it at private recordings or documents you cannot share. github.com
Your key is saved on disk
The key or login is stored under ~/.mmx. Keep it out of shared folders and repos, and prefer a key you can revoke. github.com
It needs a global npm install
The skill asks you to run npm install -g mmx-cli, which runs third-party code on your machine. The agent flags include --yes, which skips confirmation prompts. github.com
The CLI can rewrite other agents' config
The README documents mmx agent setup, which writes MiniMax settings into Claude Code, Codex and other agents' config files and backs up changed files. The skill does not ask Claude to run it. Use --dry-run to preview. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	SKILL.md defines no read-only mode. mmx has a --dry-run flag that previews an API request without executing it.
Talks to	MiniMax API: api.minimax.io (global) or api.minimaxi.com (China), for every mmx call
Sign-in and keys	mmx auth login saves an API key to ~/.mmx/config.json or an OAuth login to ~/.mmx/credentials.json.
Scopes	Claude runs the mmx command on your machine Claude can read audio and image files you point it at and upload them Claude saves generated images, video, audio and transcripts to disk

Questions

What does the mmx-cli skill do?

It teaches Claude to use the mmx command line tool to generate text, images, video and speech, transcribe audio, describe images and search the web through the MiniMax platform.

How do I install mmx-cli?

Use the install box at the top of this page. The skill is only instructions, so you must also install the mmx tool with npm and log in with MiniMax OAuth or an API key. Without that, Claude has no mmx command to run.

Do I need a paid MiniMax plan?

The sources disagree. The README header says the CLI requires a MiniMax Token Plan. The same README says the default text model, MiniMax-M3.1-Flash, is available with Token Plan, MiniMax Code and pay-as-you-go keys. SKILL.md says that model currently requires M Plan or MiniMax Code, and that a pay-as-you-go key should pass --model MiniMax-M3. Check MiniMax's plan page before you rely on either.

Does mmx-cli need an API key?

You need a login or a key. mmx auth login offers MiniMax OAuth or an API key, and you can also set MINIMAX_API_KEY. A key is saved in ~/.mmx/config.json and an OAuth login in ~/.mmx/credentials.json.

Will it spend money?

Image, video, speech and text calls use your MiniMax Token Plan quota or pay-as-you-go balance. Ask Claude to run mmx quota show first, and to use --dry-run to preview a request.

Does it work in the Claude app?

No documented route. The skill runs the mmx command on your own machine, so use Claude Code or another terminal agent. The install box leaves the Claude app tab out.

Is mmx-cli safe?

It installs a global npm package, saves your key or login on disk under ~/.mmx and sends prompts, images and audio to MiniMax. Review each command, keep the key out of shared repos and check your quota first.

Information

updated Nov 2, 2026

Repository: minimax-ai/cli
Folder: skill

minimax-ai/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

minimax-ai/cli README · github.com
mmx-cli SKILL.md · github.com
skills.sh listing · skills.sh