ElevenLabs

by elevenlabs

Recommended

690 stars

13.7k downloads

GitHub Website

About

Integrates with ElevenLabs to provide high-quality text-to-speech, voice cloning, and conversational capabilities with customizable voice profiles and audio processing features.

Details

Author: elevenlabs
Repository: elevenlabs/elevenlabs-mcp
GitHub stars: 690
Downloads: 13,703
License: MIT License
Categories: Communication, Productivity, Developer Tools, AI, Media, Other
Tags: #voice, #generative ai

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name ElevenLabs

Command (node, npx, python, etc.) uvx
Arguments
- Argument 1 elevenlabs-mcp
Environment
- ELEVENLABS_API_KEY <insert-your-api-key-here>
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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".

⚠️ 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"

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

- ELEVENLABS_MCP_BASE_PATH: Specify the base path for file operations (default: ~/Desktop). This directory is also the security boundary for input files: any path passed to a tool that reads a local file (e.g. speech_to_text, isolate_audio, speech_to_speech, video_to_music, upload_music_for_inpainting) must resolve inside this directory, whether given as an absolute or relative path. Paths outside it — even if absolute and previously accepted — are rejected. Set this to a directory that contains everything you need to read from or write to.
- ELEVENLABS_MCP_OUTPUT_MODE: Control how generated files are returned (default: files)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

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.

5.0 · 2 reviews

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

MCP ElevenLabs: spawn uvx ENOENT

Install

More like this

Time

Slack

Sentry

Github

Git

GitLab