home / mcp / minimax mcp server

Minimax MCP Server

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "minimax-ai-minimax-mcp": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "insert-your-api-key-here",
        "MINIMAX_API_HOST": "https://api.minimax.io",
        "MINIMAX_MCP_BASE_PATH": "/Users/you/Desktop",
        "MINIMAX_API_RESOURCE_MODE": "url"
      }
    }
  }
}

You can run the MiniMax MCP Server locally to interact with powerful Text to Speech and video/image generation APIs. This server exposes a set of tools you can use from MCP clients to generate speech, clone voices, create videos and images, and more. It is designed to work with MCP clients like Claude Desktop, Cursor, Windsurf, and OpenAI Agents, enabling streamlined access to MiniMax capabilities.

How to use

To start using the MiniMax MCP Server, configure your MCP client to connect via a local stdio-based server. You will run a small MCP runner that starts the minimax-mcp service and exposes its tools to your client.

Configure your MCP client

Create or update your MCP server configuration in your MCP client to point to the local minimax MCP server using the following setup.

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

Start the MCP server locally

The server runs as a local stdio process through the uvx runner. Use the following start pattern in your MCP client configuration.

uvx minimax-mcp -y

Environment and keys

Be sure your API key matches the host region to avoid authentication errors. Use the following environment variables in your client configuration:

MINIMAX_API_KEY: your API key from MiniMax MINIMAX_MCP_BASE_PATH: local output directory for generated assets MINIMAX_API_HOST: API host for your region (Global or Mainland) MINIMAX_API_RESOURCE_MODE: optional, controls how resources are accessed (url or local)"

Available tools

text_to_audio

Convert text to audio using a chosen voice.

list_voices

Retrieve the list of available voices.

voice_clone

Clone a voice from provided audio samples.

generate_video

Create a video from a textual prompt.

text_to_image

Generate an image from a textual prompt.

query_video_generation

Query results for a video generation task.

music_generation

Produce a music track from a prompt and lyrics.

voice_design

Create a custom voice from descriptive prompts with preview audio.