← Back to directory
M

MiniMax MCP

Official
Official MiniMax MCP server for text-to-speech, image generation, and video generation.
GitHub source repository ↗
★ 1.6k Stars Category · Dev Tools Very popular Source revision 0856b9aef8a9
57FMRS · C
Reliability
8/20
Security and permissions
10/20
Maintenance
13/20
Documentation
14/20
Setup experience
12/20

MiniMax MCP server is officially maintained, offers multimodal generation capabilities, easy setup, but requires attention to API key region alignment and potential costs.

Read the FMRS scoring method →

The MiniMax MCP server is the official Model Context Protocol (MCP) implementation by MiniMax, allowing MCP clients like Claude Desktop, Cursor, Windsurf, and OpenAI Agents to interact with MiniMax's AI generation APIs. It supports text-to-speech, voice cloning, text-to-image, text-to-video (with async query), music generation, and voice design.

Tools

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 an image from a prompt.
query_video_generation
Query the result of a 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.

Setup

  1. Obtain an API key from MiniMax (note regional differences). 2. Install uv (Python package manager). 3. Configure your MCP client (e.g., Claude Desktop) by adding the server config to claude_desktop_config.json.
claude_desktop_config.json
{
  "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"
      }
    }
  }
}

Fit and risk

Best for

  • Developers and content creators who need to integrate AI voice, image, and video generation quickly
  • Users who want to use MiniMax APIs directly from MCP-compatible clients

Not for

  • Users who do not need AI generation features
  • Users without a valid API key
  • Users who want offline operation or different models

Required permissions

  • Requires a valid MiniMax API key
  • May incur API usage costs
  • Can read local files or URL resources as input

Risks and side effects

  • API key mismatch or region mismatch can cause 'invalid api key' errors
  • Usage may incur costs
  • Generated content may be subject to copyright and ethical limitations

Troubleshooting

  1. Check that your API key and host are regionally aligned (Global: api.minimax.io, Mainland: api.minimaxi.com)
  2. If 'spawn uvx ENOENT' occurs, confirm the absolute path of uvx and update the config
  3. Define completion rules when using async video generation

Use cases

Broadcast a news segment
Clone a voice
Generate a video
Generate images

Supported clients

Claude DesktopFull support
CursorFull support
WindsurfFull support
OpenAI AgentsFull support