home / mcp / elevenlabs mcp enhanced

ElevenLabs MCP Enhanced

Enhanced MCP server with official v3 ElevenLabs endpoints, conversation history, and transcript retrieval.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "199-mcp-mcp-elevenlabs": {
      "command": "npx",
      "args": [
        "elevenlabs-mcp-enhanced"
      ],
      "env": {
        "ELEVENLABS_API_KEY": "YOUR_API_KEY_PLACEHOLDER",
        "ELEVENLABS_MCP_BASE_PATH": "/path/to/base"
      }
    }
  }
}

You are using an enhanced MCP server that connects to the ElevenLabs API to generate speech, manage voices, transcriptions, and conversational AI features. This server exposes convenient endpoints and client configurations so you can drive text-to-speech, dialogue generation, and conversation history from your MCP-enabled clients.

How to use

You interact with the ElevenLabs MCP Enhanced server from your MCP client by configuring it as an MCP server entry. You can run the server locally via a standard MCP client configuration or connect to it directly from clients that support MCP servers. The server provides capabilities such as single- and multi-speaker text-to-speech, dialogue generation, and conversation history retrieval with transcripts.

How to install

Prerequisites you need before starting: install Node.js 16+ for npm/npx and Python 3.11+ (Python is automatically managed by the npm package). Obtain an ElevenLabs API key from elevenlabs.io.

Zero Install (Recommended) use npx to run the MCP server without installing it system-wide.

Global install (optional) install once and run from anywhere.

Environment variable setup (optional but recommended) set ELEVENLABS_API_KEY in your shell or pass it through your MCP client configuration.

Exact commands you can use below are taken directly from practical setup steps.

# Zero Install (Recommended) - run directly with npx
npx elevenlabs-mcp-enhanced --api-key YOUR_API_KEY

# Global Install
npm install -g elevenlabs-mcp-enhanced
elevenlabs-mcp-enhanced --api-key YOUR_API_KEY

# Environment Variable (persistent per session)
export ELEVENLABS_API_KEY="YOUR_API_KEY"
npx elevenlabs-mcp-enhanced

Configured MCP server entries

The following MCP server configurations are provided for Claude Desktop and other MCP clients. Each entry uses the stdio model, running the server via a command and passing the API key through environment variables.

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "npx",
      "args": ["elevenlabs-mcp-enhanced"],
      "env": {
        "ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "python",
      "args": ["-m", "elevenlabs_mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

Available tools

text_to_speech

Convert text to speech using the v3 model with options for single- or multi-speaker output and emotive tags.

text_to_dialogue

Create multi-speaker dialogue using the v3 model, including emotion tags and formatting for natural conversations.

fetch_v3_tags

Retrieve available v3 audio tags and expressions to enhance voices and dialogue.

search_voices

Query for voices available for synthesis, including v3-optimized voices and common working voices.

get_conversation

Retrieve full conversation details including transcripts for ongoing or completed conversations.

get_conversation_history

Access historical conversation data and analysis for monitoring and auditing.