ElevenLabs

community

other

A server that integrates with ElevenLabs text-to-speech API capable of generating full voiceovers with multiple voices.

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

Installing via Smithery

To install ElevenLabs MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install elevenlabs-mcp-server --client claude

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

Clone this repository
Install dependencies:
```
uv venv
```
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

Navigate to the web UI directory:
```
cd clients/web-ui
```
Install dependencies:
```
pnpm install
```
Copy
```
.env.example
```
to
```
.env
```
and configure as needed
Run the web UI:
```
pnpm dev
```
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.