ElevenLabs MCP Server

Official
by elevenlabs
MIT License
633
  • Apple

Integrations

  • Enables Windsurf, a Codeium product, to leverage ElevenLabs' audio processing and text-to-speech capabilities.

  • Enables interaction with ElevenLabs Text to Speech and audio processing APIs, allowing for speech generation, voice cloning, audio transcription, voice design, and audio isolation capabilities.

  • Allows OpenAI Agents to use ElevenLabs' text-to-speech and audio processing features to generate and manipulate audio content.

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": "<insert-your-api-key-here>" } } } }

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:

  • "Create an AI agent that speaks like a film noir detective and can answer questions about classic movies"
  • "Generate three voice variations for a wise, ancient dragon character, then I will choose my favorite voice to add to my voice library"
  • "Convert this recording of my voice to sound like a medieval knight"
  • "Create a soundscape of a thunderstorm in a dense jungle with animals reacting to the weather"
  • "Turn this speech into text, identify different speakers, then convert it back using unique voices for each person"

Optional features

You can add the ELEVENLABS_MCP_BASE_PATH environment variable to the claude_desktop_config.json to specify the base path MCP server should look for and output files specified with relative paths.

Contributing

If you want to contribute or run from source:

  1. Clone the repository:
git clone https://github.com/elevenlabs/elevenlabs-mcp cd elevenlabs-mcp
  1. Create a virtual environment and install dependencies using uv:
uv venv source .venv/bin/activate uv pip install -e ".[dev]"
  1. Copy .env.example to .env and add your ElevenLabs API key:
cp .env.example .env # Edit .env and add your API key
  1. Run the tests to make sure everything is working:
./scripts/test.sh # Or with options ./scripts/test.sh --verbose --fail-fast
  1. Install the server in Claude Desktop: mcp install elevenlabs_mcp/server.py
  2. Debug and test locally with MCP Inspector: mcp dev elevenlabs_mcp/server.py

Troubleshooting

Logs when running with Claude Desktop can be found at:

  • Windows: %APPDATA%\Claude\logs\mcp-server-elevenlabs.log
  • macOS: ~/Library/Logs/Claude/mcp-server-elevenlabs.log

Timeouts when using certain tools

Certain ElevenLabs API operations, like voice design and audio isolation, can take a long time to resolve. When using the MCP inspector in dev mode, you might get timeout errors despite the tool completing its intended task.

This shouldn't occur when using a client like Claude.

MCP ElevenLabs: spawn uvx ENOENT

If you encounter the error "MCP ElevenLabs: spawn uvx ENOENT", confirm its absolute path by running this command in your terminal:

which uvx

Once you obtain the absolute path (e.g., /usr/local/bin/uvx), update your configuration to use that path (e.g., "command": "/usr/local/bin/uvx"). This ensures that the correct executable is referenced.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An official Model Context Protocol (MCP) server that enables AI clients to interact with ElevenLabs' Text to Speech and audio processing APIs, allowing for speech generation, voice cloning, audio transcription, and other audio-related tasks.

  1. Other MCP clients
    1. Example usage
      1. Optional features
        1. Contributing
          1. Troubleshooting
            1. Timeouts when using certain tools
            2. MCP ElevenLabs: spawn uvx ENOENT

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol (MCP) server enabling AI models to interact with the Nostr network, facilitating note posting and interaction with the freedom of speech protocol.
            Last updated -
            1
            19
            TypeScript
            MIT License
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that integrates high-quality text-to-speech capabilities with Claude Desktop and other MCP-compatible clients, supporting multiple voice options and audio formats.
            Last updated -
            TypeScript
            MIT License
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol (MCP) server that allows AI agents like Claude to interact with the Aligo SMS API to send text messages and retrieve related information.
            Last updated -
            JavaScript
            MIT License
          • A
            security
            A
            license
            A
            quality
            A Model Context Protocol (MCP) server that enables AI assistants to control and interact with Android devices, allowing for device management, app debugging, system analysis, and UI automation through natural language commands.
            Last updated -
            29
            30
            Python
            Apache 2.0
            • Linux
            • Apple

          View all related MCP servers

          ID: 98vaqoa894