MCP Directory

How to add MiniMax MCP Server (Official) to Claude Desktop

Official MiniMax server for TTS, voice cloning, music, image, and video generation. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 1.5k★ · stdio · apikey · official

Claude Desktop config for MiniMax MCP Server (Official)

uvx minimax-mcp -y
{
  "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.

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the MiniMax MCP Server (Official) config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm MiniMax MCP Server (Official)'s tools appear under the 🔌 tools menu.

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.)

What MiniMax MCP Server (Official) can do in Claude Desktop

text_to_audio

Convert text to speech (TTS) with selectable voices and parameters

list_voices

List the available system and cloned voices

voice_clone

Clone a voice from a provided audio sample

voice_design

Generate a custom voice from a natural-language description

music_generation

Generate music tracks (powered by the music-1.5 model)

text_to_image

Generate images from a text prompt

generate_video

Generate video from a text prompt, with duration/resolution controls

query_video_generation

Poll the status of an asynchronous video generation task

Security

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) + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the MiniMax MCP Server (Official) config there under the "mcpServers" key and restart the client.

Is MiniMax MCP Server (Official) safe to use with Claude Desktop?

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.

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.

View repo Full MiniMax MCP Server (Official) page