by MiniMax-AI
Enables interaction with powerful text‑to‑speech, image generation and video generation APIs through a Model Context Protocol server.
MiniMax MCP provides a server that bridges MCP‑compatible clients (e.g., Claude Desktop, Cursor, Windsurf, OpenAI Agents) with MiniMax's AI services for speech synthesis, voice cloning, image creation, video generation, and music generation.
curl -LsSf https://astral.sh/uv/install.sh | sh).uvx minimax-mcp -y (or configure your MCP client to invoke this command).MINIMAX_API_KEY – your API keyMINIMAX_API_HOST – https://api.minimax.io (global) or https://api.minimaxi.com (Mainland)MINIMAX_MCP_BASE_PATH, MINIMAX_API_RESOURCE_MODE for local file handling.claude_desktop_config.json, Cursor MCP settings).music-1.5 model.1. Invalid API key – Ensure the API key matches the selected host region (global vs. Mainland).
2. spawn uvx ENOENT – Verify uvx is in your PATH (which uvx) and use the absolute path in the client config.
3. Asynchronous video generation – Define completion rules before starting the task (see screenshots in the README) or configure them in IDE settings (e.g., Cursor).

uv (Python package manager), install with curl -LsSf https://astral.sh/uv/install.sh | sh or see the uv repo for additional install methods.Invalid API key error.| Region | Global | Mainland |
|---|---|---|
| MINIMAX_API_KEY | go get from MiniMax Global | go get from MiniMax |
| MINIMAX_API_HOST | https://api.minimax.io | https://api.minimaxi.com |
Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:
{
"mcpServers": {
"MiniMax": {
"command": "uvx",
"args": [
"minimax-mcp",
"-y"
],
"env": {
"MINIMAX_API_KEY": "insert-your-api-key-here",
"MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
"MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
"MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
}
}
}
}
⚠️ Warning: The API key needs to match the host. If an error "API Error: invalid api key" occurs, please check your api host:
https://api.minimax.iohttps://api.minimaxi.comIf you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu in the top left and select "Enable Developer Mode".
Go to Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server to add above config.
That's it. Your MCP client can now interact with MiniMax through these tools:
We support two transport types: stdio and sse.
| stdio | SSE |
|---|---|
| Run locally | Can be deployed locally or in the cloud |
Communication through stdout |
Communication through network |
Input: Supports processing local files or valid URL resources |
Input: When deployed in the cloud, it is recommended to use URL for input |
| tool | description |
|---|---|
text_to_audio |
Convert text to audio with a given voice |
list_voices |
List all voices available |
voice_clone |
Clone a voice using provided audio files |
generate_video |
Generate a video from a prompt |
text_to_image |
Generate a image from a prompt |
query_video_generation |
Query the result of video generation task |
music_generation |
Generate a music track from a prompt and lyrics |
voice_design |
Generate a voice from a prompt using preview text |
voice_design tool - create custom voices from descriptive prompts with preview audioMiniMax-Hailuo-02 model with ultra-clear quality and duration/resolution controlsmusic_generation tool powered by music-1.5 modelvoice_design - Generate personalized voices from text descriptionsgenerate_video - Now supports MiniMax-Hailuo-02 with 6s/10s duration and 768P/1080P resolution optionsmusic_generation - High-quality music creation with music-1.5 modelPlease ensure your API key and API host are regionally aligned
| Region | Global | Mainland |
|---|---|---|
| MINIMAX_API_KEY | go get from MiniMax Global | go get from MiniMax |
| MINIMAX_API_HOST | https://api.minimax.io | https://api.minimaxi.com |
Please confirm its absolute path by running this command in your terminal:
which uvx
Once you obtain the absolute path (e.g., /usr/local/bin/uvx), update your configuration to use that path (e.g., "command": "/usr/local/bin/uvx").
generate_video in async-modeDefine completion rules before starting: Alternatively, these rules can be configured in your IDE settings (e.g., Cursor):
⚠️ Warning: Using these tools may incur costs.
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by burningion
Upload, edit, search, and generate videos by leveraging LLM capabilities together with Video Jungle's media library.
by mamertofabian
Generate speech audio from text via ElevenLabs API and manage voice generation tasks through a Model Context Protocol server with a companion SvelteKit web client.
by Flyworks-AI
Create fast, free lip‑sync videos for digital avatars by providing audio or text, with optional avatar generation from images or videos.
by mberg
Generates spoken audio from text, outputting MP3 files locally and optionally uploading them to Amazon S3.
by allvoicelab
Generate natural speech, translate and dub videos, clone voices, remove hardcoded subtitles, and extract subtitles using powerful AI APIs.
by nabid-pf
Extracts YouTube video captions, subtitles, and metadata to supply structured information for AI assistants to generate concise video summaries.
by omergocmen
Provides video generation and status checking via the json2video API for seamless integration with LLMs, agents, and other MCP‑compatible clients.
by TSavo
Provides an enterprise‑grade MCP server that exposes 12 AI video generation tools, enabling AI assistants to create avatar videos, URL‑to‑video conversions, short videos, scripts, custom avatars, advanced lip‑sync, and more through natural language interactions.
by cartesia-ai
Provides clients such as Cursor, Claude Desktop, and OpenAI agents with capabilities to localize speech, convert text to audio, and infill voice clips via Cartesia's API.