ElevenLabs

What is ElevenLabs MCP?

ElevenLabs MCP is an official server for the Model Context Protocol (MCP) that enables integration with Text to Speech and audio processing APIs. It allows MCP clients to interact with ElevenLabs' voice cloning, audio transcription, and speech generation capabilities.

How to use ElevenLabs MCP?

To use ElevenLabs MCP with Claude Desktop:

1. Obtain an API key from ElevenLabs (free tier available).
2. Install the uv Python package manager.
3. Add server configuration to Claude Desktop's settings.
4. Enable Developer Mode on Windows.

For other clients like Cursor or Windsurf:

1. Install the package: pip install elevenlabs-mcp
2. Run it with your API key to get configuration details.
3. Paste the configuration into your MCP client's settings.

Key features of ElevenLabs MCP

• Text-to-speech conversion
• AI voice cloning
• Audio transcription and processing
• Integration with multiple MCP clients (Claude Desktop, Cursor, Windsurf, OpenAI Agents)
• Python-based configuration and automation

Use cases of ElevenLabs MCP

1. AI agents: Generate speech for agents in different personas (e.g., film noir detective).
2. Voice library: Create variations of a character’s voice (e.g., dragon character voices).
3. Audio transformation: Modify voice recordings (e.g., medieval knight voice).
4. Soundscape generation: Create immersive audio environments (e.g., jungle thunderstorm).
5. Speaker identification: Transcribe multi-speaker audio and convert it back with distinct voices.

FAQ about ElevenLabs MCP

• Is there a free tier available?

  Yes, ElevenLabs provides a free tier with 10,000 credits per month.

• How do I troubleshoot timeout errors?

  Long API operations (like voice design) may timeout in MCP Inspector but work in clients like Claude. Check logs in %APPDATA%\Claude\logs\ (Windows) or ~/Library/Logs/Claude/ (macOS).

• What if I get "spawn uvx ENOENT" errors?

  Confirm the path to uvx using which uvx and update the configuration with the absolute path.

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: - "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: ```bash git clone https://github.com/elevenlabs/elevenlabs-mcp cd elevenlabs-mcp ``` 2. Create a virtual environment and install dependencies [using uv](https://github.com/astral-sh/uv): ```bash uv venv source .venv/bin/activate uv pip install -e ".[dev]" ``` 3. Copy `.env.example` to `.env` and add your ElevenLabs API key: ```bash cp .env.example .env # Edit .env and add your API key ``` 4. Run the tests to make sure everything is working: ```bash ./scripts/test.sh # Or with options ./scripts/test.sh --verbose --fail-fast ``` 5. Install the server in Claude Desktop: `mcp install elevenlabs_mcp/server.py` 6. 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: ```bash 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.