home / mcp / elevenlabs mcp server

ElevenLabs MCP Server

Provides access to ElevenLabs features (text-to-speech, voices, audio transformation, history) via MCP endpoints.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "afarhadi99-elevenlabs-mcp": {
      "url": "your-smithery-deployment-url"
    }
  }
}

You can run and connect an MCP server to ElevenLabs for access to text-to-speech, voice management, audio transformation, and history features. This guide shows practical steps to install, configure, and use the ElevenLabs MCP Server with your MCP client, enabling you to generate speech, manage voices, transform audio, and inspect history and subscriptions from a single, consistent interface.

How to use

Connect your MCP client to the ElevenLabs MCP Server using the provided deployment URL and your ElevenLabs API key. Once connected, you can use the available tools to generate speech, list and inspect voices, transform audio, remove noise, and manage history and subscriptions. The server supports both HTTP-based remote connections and local development workflows. Use the HTTP connection when you have a deployed MCP endpoint, and use local development workflows to iterate quickly against your own environment.

How to install

Prerequisites: Install Node.js (recommended LTS version) and a modern package manager.

npm install
```

```
npm run dev
```

```
npm run build

Configuration and usage examples

Configure your MCP client to connect to the ElevenLabs MCP Server using the deployment URL provided by your Smithery deployment. The server expects an API key for ElevenLabs access.

If you are using Claude Desktop or Cursor, add a MCP configuration that points to your Smithery deployment and includes your ElevenLabs API key.

{
  "mcpServers": {
    "elevenlabs": {
      "url": "your-smithery-deployment-url",
      "config": {
        "apiKey": "your-elevenlabs-api-key"
      }
    }
  }
}

Security and keys

Keep your ElevenLabs API key secret. Do not expose it in client-side code or public repositories. Use environment-specific configuration to inject the API key at runtime when supported by your MCP client.

Troubleshooting and notes

If you encounter connection issues, verify that the deployment URL is reachable and that the API key is valid. Check network policies and ensure your MCP client is configured to point to the correct endpoint. For development, use npm run dev to start the server with hot reloading.

All assets from the ElevenLabs features can be accessed through the MCP interface, including text-to-speech, voice management, audio transformation, and history endpoints.

Appendix: Tools available through the ElevenLabs MCP Server

Text to Speech: convert text to speech with customizable voice settings and real-time streaming.

Available tools

text-to-speech

Convert text to speech with customizable voice settings and options.

text-to-speech-streaming

Stream synthesized speech in real-time as it is generated.

get-voices

List all available voices with search and filtering capabilities.

get-voice

Retrieve detailed information about a specific voice.

get-models

List all available AI models.

speech-to-speech

Transform audio from one voice to another (voice changer).

sound-generation

Create sound effects from descriptive text inputs.

audio-isolation

Remove background noise from audio files.

get-history

Fetch the history of all generated audio.

get-history-item

Retrieve a specific history item by ID.

get-history-item-audio

Download audio from a history item.

delete-history-item

Delete a history item.

get-user

Get current user information.

get-subscription

Get user subscription details.