MCP Directory

MiniMax MCP Server (Official)

Official

Official MiniMax server for TTS, voice cloning, music, image, and video generation.

Verified
stdio (local)
API key
Python

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run
uvx minimax-mcp -y

Paste 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_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

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

  1. 1Install Python and the uv package manager
  2. 2Sign in to MiniMax and create an API key, noting your region (global vs mainland)
  3. 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
  4. 4Restart the MCP client so it picks up the new server
  5. 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.

Verified
stdio (local)
API key
TypeScript
2 tools
Updated 19 days agoRepo

Official ElevenLabs server for text-to-speech, voice cloning, sound effects, and audio.

Verified
stdio (local)
API key
Python
14 tools
Updated 5 months agoRepo

Official Figma server that brings design context, variables, and components into AI coding tools.

Verified
HTTP (remote)
OAuth
Hosted
12 tools
Updated 26 days agoRepo