MiniMax MCP server

Enables high-quality text-to-speech, voice cloning, and video generation capabilities through MiniMax's API with robust error handling and file management features.
Back to servers
Setup instructions
Provider
MiniMax AI
Release date
Apr 10, 2025
Language
Python
Package
Stats
338.0K downloads
815 stars

The MiniMax Model Context Protocol (MCP) server enables interaction with powerful Text to Speech and multimedia generation APIs. It allows MCP clients like Claude Desktop, Cursor, Windsurf, and OpenAI Agents to generate speech, clone voices, and create videos and images.

Quickstart with MCP Client

Initial Setup

  1. Get your API key from MiniMax

  2. Install uv (Python package manager):

    curl -LsSf https://astral.sh/uv/install.sh | sh
    

    Or see the uv repository for other installation methods

  3. Important: The API host and key must match by region to avoid an "Invalid API key" error:

Region Global Mainland
MINIMAX_API_KEY From MiniMax Global From MiniMax
MINIMAX_API_HOST https://api.minimax.io https://api.minimaxi.com

Configuration for Claude Desktop

Navigate to Claude > Settings > Developer > Edit Config > claude_desktop_config.json and add:

{
  "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"
      }
    }
  }
}

⚠️ For Windows users: Enable "Developer Mode" in Claude Desktop by clicking "Help" in the hamburger menu and selecting "Enable Developer Mode".

Configuration for Cursor

Go to Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server to add the same configuration.

Transport Types

The server supports two transport types:

stdio SSE
Runs locally Can be deployed locally or in the cloud
Communication through stdout Communication through network
Supports processing local files or valid URL resources When deployed in cloud, URL inputs recommended

Available Tools

Tool Description
text_to_audio Convert text to audio with a given voice
list_voices List all available voices
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 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

Recent Updates

July 2, 2025

New Features

  • Voice Design: New voice_design tool to create custom voices from descriptive prompts
  • Video Enhancement: Added MiniMax-Hailuo-02 model with ultra-clear quality and duration/resolution controls
  • Music Generation: Enhanced music_generation tool powered by music-1.5 model

Troubleshooting

Invalid API Key

Ensure your API key and API host are regionally aligned:

Region Global Mainland
MINIMAX_API_KEY From MiniMax Global From MiniMax
MINIMAX_API_HOST https://api.minimax.io https://api.minimaxi.com

"spawn uvx ENOENT" Error

Find the absolute path to uvx:

which uvx

Then update your configuration with the absolute path (e.g., "command": "/usr/local/bin/uvx").

Using Asynchronous Video Generation

Define completion rules before starting by configuring them in your IDE settings (e.g., Cursor).

Usage Examples

⚠️ Warning: Using these tools may incur costs.

The MCP server enables various multimedia generation capabilities including:

  • News broadcast generation
  • Voice cloning
  • Video generation
  • Image generation

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "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"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "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"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "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"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later