
MiniMax MCP Server (Official)
OfficialOfficial MiniMax server for TTS, voice cloning, music, image, and video generation.
Add to your client
Copy the config for your MCP client and paste it into its config file.
uvx minimax-mcp -yPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"minimax-mcp-server-official": {
"command": "uvx",
"args": [
"minimax-mcp",
"-y"
],
"env": {
"MINIMAX_API_KEY": "<your-api-key>",
"MINIMAX_API_HOST": "https://api.minimax.io",
"MINIMAX_MCP_BASE_PATH": "/absolute/path/to/output/dir"
}
}
}
}Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.
Before you start
- Python with the uv package manager installed (the server is launched via uvx/uv)
- A MiniMax API key from your account at the MiniMax platform (platform key page, region-specific)
- The correct regional API host: https://api.minimax.io (global) or https://api.minimaxi.com (mainland China) — host and key must match the same region
- A writable local output directory for generated audio/image/video files
- An MCP-capable client (Claude Desktop, Cursor, Windsurf, etc.)
About MiniMax MCP Server (Official)
MiniMax MCP is the official Model Context Protocol server from MiniMax that exposes the company's generative media APIs to MCP clients such as Claude Desktop, Cursor, Windsurf, and other agents. From a single server you can synthesize speech, clone and design voices, generate music, create images, and produce video, all driven by natural-language prompts.
The server runs locally over stdio using Python and the uv package manager, and writes generated assets to an output directory you configure. It calls the MiniMax hosted API, so you supply an API key and the matching regional host.
A key gotcha: MiniMax operates two regions with separate hosts and keys. The global host is https://api.minimax.io and the mainland China host is https://api.minimaxi.com. The host and key must come from the same region or requests fail with an Invalid API key error.
Tools & capabilities (8)
text_to_audioConvert text to speech (TTS) with selectable voices and parameters
list_voicesList the available system and cloned voices
voice_cloneClone a voice from a provided audio sample
voice_designGenerate a custom voice from a natural-language description
music_generationGenerate music tracks (powered by the music-1.5 model)
text_to_imageGenerate images from a text prompt
generate_videoGenerate video from a text prompt, with duration/resolution controls
query_video_generationPoll the status of an asynchronous video generation task
When to use it
- Use it when you need to turn scripts or articles into natural-sounding speech directly from your agent
- Use it when you want to clone or design a custom voice for narration, characters, or branded audio
- Use it when generating background music or jingles from a prompt for video or app projects
- Use it when you need on-demand image generation inside an MCP workflow
- Use it when producing short videos from text and need to poll the job until it completes
Quick setup
- 1Install Python and the uv package manager
- 2Sign in to MiniMax and create an API key, noting your region (global vs mainland)
- 3Add the MiniMax server to your MCP client config (e.g. Claude Desktop: Settings > Developer > Edit Config), passing the API key, matching API host, and an output directory
- 4Restart the MCP client so it picks up the new server
- 5Verify by calling list_voices, then try a text_to_audio request
Security notes
Set MINIMAX_API_HOST to match the region where your API key was issued or calls will fail with an invalid-key error; the key bills your MiniMax account. Generated media is written to the configured local base path.
MiniMax MCP Server (Official) FAQ
Why do I get an 'Invalid API key' error?
Almost always a region mismatch: the API host and key must be from the same region. Pair a global key with https://api.minimax.io, or a mainland key with https://api.minimaxi.com.
Where do generated files go?
To the output directory you set in the server configuration; tools return file paths (or URLs) for the generated audio, image, and video assets.
Is video generation synchronous?
No. generate_video starts a job and you poll query_video_generation until the task finishes, then download the result.
Which clients are supported?
Any MCP-capable client over stdio — the README documents Claude Desktop, Cursor, and Windsurf among others.
Is it free?
The server is open source (MIT), but the underlying MiniMax APIs are paid and require account credits/billing.
Alternatives to MiniMax MCP Server (Official)
Popular community server that feeds Figma layout data to coding agents via a Figma API token.
Official ElevenLabs server for text-to-speech, voice cloning, sound effects, and audio.
Official Figma server that brings design context, variables, and components into AI coding tools.
Compare MiniMax MCP Server (Official) with: