ElevenLabs MCP Server

ElevenLabs is an AI-powered voice synthesis platform that generates realistic speech from text and provides advanced audio processing capabilities. The official MCP server enables AI coding assistants to access ElevenLabs' voice AI technology through programmable tools. Key features of ElevenLabs MCP Server: - Text-to-speech generation with natural-sounding AI voices in multiple languages and accents - Voice cloning to create custom voice profiles from audio samples - Audio transcription for converting speech to text - Voice variation tools for developing distinct character voices and speaking styles - Integration with popular MCP clients including Claude Desktop, Cursor, Windsurf, and OpenAI Agents - Access to ElevenLabs' library of pre-trained voices with diverse styles and emotions

[](https://discord.gg/elevenlabs) [](https://x.com/ElevenLabsDevs) [](https://pypi.org/project/elevenlabs-mcp) [](https://github.com/elevenlabs/elevenlabs-mcp-server/actions/workflows/test.yml)

Official ElevenLabs Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech and audio processing APIs. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to generate speech, clone voices, transcribe audio, and more.

Quickstart with Claude Desktop

1. Get your API key from ElevenLabs. There is a free tier with 10k credits per month. 2. Install uv (Python package manager), install with curl -LsSf https://astral.sh/uv/install.sh | sh or see the uv repo for additional install methods. 3. Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": ""
      }
    }
  }
}

If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu at the top left and select "Enable Developer Mode".

Other MCP clients

For other clients like Cursor and Windsurf, run: 1. pip install elevenlabs-mcp 2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print to get the configuration. Paste it into appropriate configuration directory specified by your MCP client.

That's it. Your MCP client can now interact with ElevenLabs through these tools:

Example usage

⚠️ Warning: ElevenLabs credits are needed to use these tools.

Try asking Claude:

Optional features

File Output Configuration

You can configure how the MCP server handles file outputs using these environment variables in your claude_desktop_config.json:

#### Output Modes

The ELEVENLABS_MCP_OUTPUT_MODE environment variable supports three modes:

1. files (default): Save files to disk and return file paths

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "files"
   }
   

2. resources: Return files as MCP resources; binary data is base64-encoded, text is returned as UTF-8 text

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "resources"
   }
   

3. both: Save files to disk AND return as MCP resources

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "both"
   }
   

Resource Mode Benefits:

Use Cases: