Elevenlabs MCP Server

🚀 ElevenLabs MCP Server

An MCP (Model Context Protocol) server integrating the ElevenLabs Text-to-Speech API, including a server component and an example SvelteKit-based MCP client for managing voice generation tasks.

✨ Features

• Generate audio from text using the ElevenLabs API.
• Support multiple voices and script segments.
• Store history using an SQLite database.
• Features of the example SvelteKit MCP client:
  • Simple text-to-speech conversion.
  • Multi-segment script management.
  • Voice history tracking and playback.
  • Audio file download.

📦 Installation

Install via Smithery

Automatically install the ElevenLabs MCP Server on Claude Desktop using Smithery:

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

Use uvx (Recommended)

When using uvx, no special installation is required.

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", // Replace with your API key
        "ELEVENLABS_VOICE_ID": "your-voice-id", // Replace with your selected 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"
      }
    }
  }
}

💻 Usage Examples

Use the SvelteKit-based MCP client:

1. Navigate to the directory:

   cd your-project-directory
   

2. Install dependencies:

   npm install
   

3. Configure environment variables and start the service.

Tools

• text-to-speech: Convert text to speech.
• script-manager: Manage multiple script segments.

Resources

• URL patterns:
  • http://localhost:5000/text-to-speech
  • http://localhost:5000/script-manager

📄 License

MIT License