MiniMax MCP
Official MiniMax MCP server: text to speech, voice cloning and design, image and video generation
Install
{
"mcpServers": {
"MiniMax": {
"command": "uvx",
"args": ["minimax-mcp", "-y"],
"env": {
"MINIMAX_API_KEY": "insert-your-api-key-here",
"MINIMAX_MCP_BASE_PATH": "/path/to/output",
"MINIMAX_API_HOST": "https://api.minimax.io",
"MINIMAX_API_RESOURCE_MODE": "url"
}
}
}
}The same snippet works in Cursor. Requires uv.
This is third-party code. Review the repository files before installing.
What it does
The server connects the agent to the MiniMax API with tools to voice text with a chosen voice, list voices, clone a voice from audio and design a voice from a description. It also generates images from prompts and videos, including the Hailuo-02 model, with a separate tool to poll generation status. Results come back as URLs or are saved to a local folder. It runs over stdio or SSE.
Who it is for. For content creators and developers who need voiceover, images and video straight from the agent.
Good fit when
- You need to voice a text or create a voice from a description
- You need a short video or an image from a prompt
- You need to clone a voice from a sample recording
Not a fit when
- You have no MiniMax account or budget for paid calls
- Audio and text must not go to a third-party service
Example request
Voice this paragraph with a calm male voice and save the file to my desktopLimitations
Requires a MiniMax API key and calls are paid. The key and API host must belong to the same region or you get invalid api key. Requires uv. The authors now recommend their mmx-cli as the primary tool. API availability from Russia without a VPN is unverified.
How to disable. Remove the MiniMax block from claude_desktop_config.json or Cursor's MCP settings.
MCP
- Transport
- stdio, sse
- Authentication
- API key
| Environment variables | |
|---|---|
| MINIMAX_API_KEY required, secret | MiniMax API key |
| MINIMAX_API_HOST required | API host matching the key's region |
| MINIMAX_MCP_BASE_PATH | Folder for saved files |
| MINIMAX_API_RESOURCE_MODE | url or local: how audio, images and video are returned |
Security check
- Paid external API calls
- Sends text and voice samples to a third-party service
- Writes files to a local folder
README in short
The README shows setup for Claude Desktop and Cursor through uvx and explains regional keys and hosts. It lists voice, image and video tools, describes stdio and SSE transports and URL or local file output. It warns that calls cost money and points to mmx-cli as the newer option. MIT licensed.
FAQ
How to fix invalid api key?
Make sure the key and host are from the same region: global api.minimax.io or mainland api.minimaxi.com.
The client reports spawn uvx ENOENT
Find the full path with which uvx and put it in the command field.
Related
Skills and CLI from HeyGen: the agent writes HTML compositions and renders them into MP4 videos, captions, motion graphics and decks
Blender MCP
MCP for Blender
An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender
Official Remotion skills for making videos in React: compositions, animation, captions, maps and rendering
Agentic video studio for Claude Code, Cursor and Codex: script, voiceover, images, stock footage, music, subtitles and render