https://github.com/mamertofabian/elevenlabs-mcp-server
https://github.com/mamertofabian/elevenlabs-mcp-server
Last synced: 23 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/mamertofabian/elevenlabs-mcp-server
- Owner: mamertofabian
- License: mit
- Created: 2024-12-21T02:14:55.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-01-07T23:12:10.000Z (3 months ago)
- Last Synced: 2025-01-08T00:21:09.148Z (3 months ago)
- Language: Python
- Size: 200 KB
- Stars: 7
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-zh - ElevenLabs
- Awesome-MCP-Servers-directory - ElevenLabs - A server that integrates with ElevenLabs text-to-speech API capable of generating full voiceovers with multiple voices (AI Services)
- awesome-mcp-servers - ElevenLabs - Generates speech from text using the ElevenLabs API, managing tasks via a server and web-based client (Table of Contents / AI Services)
README
# ElevenLabs MCP Server
[](https://smithery.ai/server/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](https://smithery.ai/server/elevenlabs-mcp-server):
```bash
npx -y @smithery/cli install elevenlabs-mcp-server --client claude
```
### Using uvx (recommended)
When using [`uvx`](https://docs.astral.sh/uv/guides/tools/), no specific installation is needed.
Add the following configuration to your MCP settings file (e.g., `cline_mcp_settings.json` for Claude Desktop):
```json
{
"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:
```bash
uv venv
```
3. Copy `.env.example` to `.env` and fill in your ElevenLabs credentials
```json
{
"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:
```bash
cd clients/web-ui
```
2. Install dependencies:
```bash
pnpm install
```
3. Copy `.env.example` to `.env` and configure as needed
4. Run the web UI:
```bash
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](LICENSE) file for details.