ElevenLabs MCP Server
About
ElevenLabs MCP Server is a Model Context Protocol (MCP) server that integrates with the ElevenLabs text-to-speech API. It includes a server component and a sample SvelteKit web-based MCP client for managing voice generation tasks.
Details
- Author
- MCP-Mirror
- Downloads
- 399
- Categories
- Other
Jump to
- Generate audio from text using ElevenLabs API
- Support for multiple voices and script parts
- SQLite database for persistent history storage
- Voice history tracking and playback
- Audio file downloads
- Sample SvelteKit MCP Client included
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 MCP ServerCommand (node, npx, python, etc.)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
From the repository
Install using uvx (no specific installation needed) and add the configuration to your MCP settings file, providing your ELEVENLABS_API_KEY, ELEVENLABS_VOICE_ID, and optional parameters like ELEVENLABS_MODEL_ID. For development, clone the repository, install dependencies with uv venv, copy .env.example to .env, and fill in your credentials. To use the sample web UI, navigate to clients/web-ui, run pnpm install, configure .env, and start with pnpm dev.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"elevenlabs mcp server": {
"mamertofabian_elevenlabs-mcp-server": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"mamertofabian_elevenlabs-mcp-server": {
"command": "uv",
"args": [
"venv"
]
}
}ElevenLabs MCP Server
A Model Context Protocol (MCP) server that integrates with ElevenLabs text-to-speech API, featuring both a server component and a sample web-based MCP Client (SvelteKit) for managing voice generation tasks.
Features
- Generate audio from text using ElevenLabs API
- Support for multiple voices and script parts
- SQLite database for persistent history storage
- Sample SvelteKit MCP Client for:
- Simple text-to-speech conversion
- Multi-part script management
- Voice history tracking and playback
- Audio file downloads
Installation
Using uvx (recommended)
When using uvx, no specific installation is needed.
Add the following configuration to your MCP settings file (e.g., cline_mcp_settings.json for Claude Desktop):
{
"mcpServers": {
"elevenlabs": {
"command": "uvx",
"args": ["elevenlabs-mcp-server"],
"env": {
"ELEVENLABS_API_KEY": "your-api-key",
"ELEVENLABS_VOICE_ID": "your-voice-id",
"ELEVENLABS_MODEL_ID": "eleven_flash_v2",
"ELEVENLABS_STABILITY": "0.5",
"ELEVENLABS_SIMILARITY_BOOST": "0.75",
"ELEVENLABS_STYLE": "0.1",
"ELEVENLABS_OUTPUT_DIR": "output"
}
}
}
}
Development Installation
1. Clone this repository
2. Install dependencies:
uv venv
3. Copy
.env.example to .env and fill in your ElevenLabs credentials
{
"mcpServers": {
"elevenlabs": {
"command": "uv",
"args": [
"--directory",
"path/to/elevenlabs-mcp-server",
"run",
"elevenlabs-mcp-server"
],
"env": {
"ELEVENLABS_API_KEY": "your-api-key",
"ELEVENLABS_VOICE_ID": "your-voice-id",
"ELEVENLABS_MODEL_ID": "eleven_flash_v2",
"ELEVENLABS_STABILITY": "0.5",
"ELEVENLABS_SIMILARITY_BOOST": "0.75",
"ELEVENLABS_STYLE": "0.1",
"ELEVENLABS_OUTPUT_DIR": "output"
}
}
}
}
Using the Sample SvelteKit MCP Client
1. Navigate to the web UI directory:
cd clients/web-ui
2. Install dependencies:
pnpm install
3. Copy
.env.example to .env and configure as needed4. Run the web UI:
pnpm dev
5. Open http://localhost:5174 in your browser
Available Tools
- generate_audio_simple: Generate audio from plain text using default voice settings
- generate_audio_script: Generate audio from a structured script with multiple voices and actors
- delete_job: Delete a job by its ID
- get_audio_file: Get the audio file by its ID
- list_voices: List all available voices
- get_voiceover_history: Get voiceover job history. Optionally specify a job ID for a specific job.
Available Resources
- voiceover://history/{job_id}: Get the audio file by its ID
- voiceover://voices: List all available voices
License
This project is licensed under the MIT License - see the LICENSE file for details.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
