Skip to content
Back to search

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…

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mamertofabian--elevenlabs-mcp-server/badge.svg)](/listings/mamertofabian--elevenlabs-mcp-server)

HTML

<a href="/listings/mamertofabian--elevenlabs-mcp-server"><img src="/api/listings/mamertofabian--elevenlabs-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing via Smithery

To install ElevenLabs MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/elevenlabs-mcp-server):

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):

{
  "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"
      }
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 122 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # ElevenLabs MCP Server
  2. [![smithery badge](https://smithery.ai/badge/elevenlabs-mcp-server)](https://smithery.ai/server/elevenlabs-mcp-server)
  3. 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.
  4. <a href="https://glama.ai/mcp/servers/leukzvus7o"><img width="380" height="200" src="https://glama.ai/mcp/servers/leukzvus7o/badge" alt="ElevenLabs Server MCP server" /></a>
  5. ## Features
  6. - Generate audio from text using ElevenLabs API
  7. - Support for multiple voices and script parts
  8. - SQLite database for persistent history storage
  9. - Sample SvelteKit MCP Client for:
  10. - Simple text-to-speech conversion
  11. - Multi-part script management
  12. - Voice history tracking and playback
  13. - Audio file downloads
  14. ## Installation
  15. ### Installing via Smithery
  16. To install ElevenLabs MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/elevenlabs-mcp-server):
  17. ```bash
  18. npx -y @smithery/cli install elevenlabs-mcp-server --client claude
  19. ```
  20. ### Using uvx (recommended)
  21. When using [`uvx`](https://docs.astral.sh/uv/guides/tools/), no specific installation is needed.
  22. Add the following configuration to your MCP settings file (e.g., `cline_mcp_settings.json` for Claude Desktop):
  23. ```json
  24. {
  25. "mcpServers": {
  26. "elevenlabs": {
  27. "command": "uvx",
  28. "args": ["elevenlabs-mcp-server"],
  29. "env": {
  30. "ELEVENLABS_API_KEY": "your-api-key",
  31. "ELEVENLABS_VOICE_ID": "your-voice-id",
  32. "ELEVENLABS_MODEL_ID": "eleven_flash_v2",
  33. "ELEVENLABS_STABILITY": "0.5",
  34. "ELEVENLABS_SIMILARITY_BOOST": "0.75",
  35. "ELEVENLABS_STYLE": "0.1",
  36. "ELEVENLABS_OUTPUT_DIR": "output"
  37. }
  38. }
  39. }
  40. }
  41. ```
  42. ### Development Installation
  43. 1. Clone this repository
  44. 2. Install dependencies:
  45. ```bash
  46. uv venv
  47. ```
  48. 3. Copy `.env.example` to `.env` and fill in your ElevenLabs credentials
  49. ```json
  50. {
  51. "mcpServers": {
  52. "elevenlabs": {
  53. "command": "uv",
  54. "args": [
  55. "--directory",
  56. "path/to/elevenlabs-mcp-server",
  57. "run",
  58. "elevenlabs-mcp-server"
  59. ],
  60. "env": {
  61. "ELEVENLABS_API_KEY": "your-api-key",
  62. "ELEVENLABS_VOICE_ID": "your-voice-id",
  63. "ELEVENLABS_MODEL_ID": "eleven_flash_v2",
  64. "ELEVENLABS_STABILITY": "0.5",
  65. "ELEVENLABS_SIMILARITY_BOOST": "0.75",
  66. "ELEVENLABS_STYLE": "0.1",
  67. "ELEVENLABS_OUTPUT_DIR": "output"
  68. }
  69. }
  70. }
  71. }
  72. ```
  73. ## Using the Sample SvelteKit MCP Client
  74. 1. Navigate to the web UI directory:
  75. ```bash
  76. cd clients/web-ui
  77. ```
  78. 2. Install dependencies:
  79. ```bash
  80. pnpm install
  81. ```
  82. 3. Copy `.env.example` to `.env` and configure as needed
  83. 4. Run the web UI:
  84. ```bash
  85. pnpm dev
  86. ```
  87. 5. Open http://localhost:5174 in your browser
  88. ### Available Tools
  89. - `generate_audio_simple`: Generate audio from plain text using default voice settings
  90. - `generate_audio_script`: Generate audio from a structured script with multiple voices and actors
  91. - `delete_job`: Delete a job by its ID
  92. - `get_audio_file`: Get the audio file by its ID
  93. - `list_voices`: List all available voices
  94. - `get_voiceover_history`: Get voiceover job history. Optionally specify a job ID for a specific job.
  95. ### Available Resources
  96. - `voiceover://history/{job_id}`: Get the audio file by its ID
  97. - `voiceover://voices`: List all available voices
  98. ## License
  99. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.