Name | elevenlabs-mcp JSON |
Version |
0.1.8
JSON |
| download |
home_page | None |
Summary | Eleven Labs MCP Server |
upload_time | 2025-04-07 13:32:38 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.11 |
license | MIT License
Copyright (c) 2025 Eleven Labs Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
|
keywords |
elevenlabs
mcp
text-to-speech
speech-to-text
voice-cloning
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# ElevenLabs MCP Server
[](https://discord.gg/elevenlabs)
[](https://x.com/ElevenLabsDevs)
[](http://pypi.org/project/elevenlabs-mcp) [](https://pypi.org/project/elevenlabs-mcp)
[](https://github.com/elevenlabs/elevenlabs-mcp-server/actions/workflows/test.yml)
Official ElevenLabs Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech and audio processing APIs. This server allows MCP clients like [Claude Desktop](https://www.anthropic.com/claude), [Cursor](https://www.cursor.so), [Windsurf](https://codeium.com/windsurf), [OpenAI Agents](https://github.com/openai/openai-agents-python) and others to generate speech, clone voices, transcribe audio, and more.
## Quick Start with Claude
1. Get your API key from [ElevenLabs](https://elevenlabs.io/). There is a free tier with 10k credits per month.
2. Install `elevenlabs_mcp` module with `pip install elevenlabs-mcp`.
3. Install the MCP server in Claude Desktop by running `python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}}`.
4. Restart Claude Desktop.
If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu in the top left and select "Enable Developer Mode".
## Other MCP clients
For other clients like Cursor and Windsurf, run `python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print` to get the configuration. Paste it into appropriate configuration directory specified by your MCP client.
That's it! Your MCP client can now interact with ElevenLabs through these tools:
- `text_to_speech`: Convert text to speech using a specified voice
- `voice_clone`: Clone a voice using provided audio files
- `speech_to_text`: Transcribe speech from an audio file
- `text_to_sound_effects`: Generate sound effects from text descriptions
- `isolate_audio`: Isolate audio from a file
- `check_subscription`: Check your ElevenLabs subscription status
- `list_voices`: Get a list of all available voices
- `search_voices`: Search through your voice library for a specific voice
- `get_voice`: Retrieve a specific voice by ID
- `speech_to_speech`: Transform audio from one voice to another using provided audio files
- `text_to_voice`: Design a voice via a text prompt
- `create_voice_from_preview`: Using an ID from `text_to_voice`, save your generated to your library
- `create_agent`: Create a Conversational AI agent
- `list_agents`: Retrieve a list of all available Conversational AI agents
- `get_agent`: Retrieve a specific agent by ID
- `add_knowledge_base_to_agent`: Add knowledge to your Conversational AI agent. Useful for piping LLM deep research into an agent's knowledge base
- `make_outbound_call` - Make an outbound call via Twilio using an ElevenLabs agent
- `list_phone_numbers` - List all phone numbers associated with your ElevenLabs account
- `play_audio`: Play audio directly from the client
## Example Usage
Try asking Claude:
- "Can you convert this text to speech using a British accent?"
- "What voices are available for text-to-speech?"
- "Can you transcribe this audio file for me?"
- "Generate some rain sound effects"
- "Play that generated voice clip for me"
- "Generate the voice of a jolly giant"
## Optional features
You can add the `ELEVENLABS_MCP_BASE_PATH` environment variable to the `claude_desktop_config.json` to specify the base path MCP server should look for and output files specified with relative paths.
## Contributing
If you want to contribute or run from source:
1. Clone the repository:
```bash
git clone https://github.com/elevenlabs/elevenlabs-mcp-server
cd elevenlabs-mcp-server
```
2. Create a virtual environment and install dependencies [using uv](https://github.com/astral-sh/uv):
```bash
uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"
```
3. Copy `.env.example` to `.env` and add your ElevenLabs API key:
```bash
cp .env.example .env
# Edit .env and add your API key
```
4. Run the tests to make sure everything is working:
```bash
./test.sh
# Or with options
./test.sh --verbose --fail-fast
```
5. Install the server in Claude Desktop: `mcp install elevenlabs_mcp/server.py`
6. Debug and test locally with MCP Inspector: `mcp dev elevenlabs_mcp/server.py`
## Requirements
- Python 3.11 or higher
- Dependencies:
- mcp>=0.1.0
- fastapi==0.109.2
- uvicorn==0.27.1
- python-dotenv==1.0.1
- pydantic>=2.6.1
- httpx==0.28.1
- elevenlabs>=1.56.0
## Troubleshooting
Logs when running with Claude Desktop can be found at:
- **Windows**: `%APPDATA%\Claude\logs\mcp-server-elevenlabs.log`
- **macOS**: `~/Library/Logs/Claude/mcp-server-elevenlabs.log`
### Timeouts when using certain tools
Certain ElevenLabs API operations like voice design and audio isolation can take a long time to resolve. When using the MCP inspector in dev mode you might get timeout errors, despite the tool completing its intended task.
This shouldn't occur when using a client like Claude.
Raw data
{
"_id": null,
"home_page": null,
"name": "elevenlabs-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "elevenlabs, mcp, text-to-speech, speech-to-text, voice-cloning",
"author": null,
"author_email": "Jacek Duszenko <jacek@elevenlabs.io>, Paul Asjes <paul.asjes@elevenlabs.io>, Louis Jordan <louis@elevenlabs.io>, Luke Harries <luke@elevenlabs.io>",
"download_url": "https://files.pythonhosted.org/packages/94/ba/485511d4f22e1a1a1796d5f2e5cc1fbce417ebf74d4ee760576f8fd780fd/elevenlabs_mcp-0.1.8.tar.gz",
"platform": null,
"description": "# ElevenLabs MCP Server\n\n[](https://discord.gg/elevenlabs)\n[](https://x.com/ElevenLabsDevs)\n[](http://pypi.org/project/elevenlabs-mcp) [](https://pypi.org/project/elevenlabs-mcp)\n[](https://github.com/elevenlabs/elevenlabs-mcp-server/actions/workflows/test.yml)\n\nOfficial ElevenLabs Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech and audio processing APIs. This server allows MCP clients like [Claude Desktop](https://www.anthropic.com/claude), [Cursor](https://www.cursor.so), [Windsurf](https://codeium.com/windsurf), [OpenAI Agents](https://github.com/openai/openai-agents-python) and others to generate speech, clone voices, transcribe audio, and more.\n\n## Quick Start with Claude\n\n1. Get your API key from [ElevenLabs](https://elevenlabs.io/). There is a free tier with 10k credits per month.\n2. Install `elevenlabs_mcp` module with `pip install elevenlabs-mcp`.\n3. Install the MCP server in Claude Desktop by running `python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}}`.\n4. Restart Claude Desktop.\n\nIf you're using Windows, you will have to enable \"Developer Mode\" in Claude Desktop to use the MCP server. Click \"Help\" in the hamburger menu in the top left and select \"Enable Developer Mode\".\n\n## Other MCP clients\n\nFor other clients like Cursor and Windsurf, run `python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print` to get the configuration. Paste it into appropriate configuration directory specified by your MCP client.\n\nThat's it! Your MCP client can now interact with ElevenLabs through these tools:\n\n- `text_to_speech`: Convert text to speech using a specified voice\n- `voice_clone`: Clone a voice using provided audio files\n- `speech_to_text`: Transcribe speech from an audio file\n- `text_to_sound_effects`: Generate sound effects from text descriptions\n- `isolate_audio`: Isolate audio from a file\n- `check_subscription`: Check your ElevenLabs subscription status\n- `list_voices`: Get a list of all available voices\n- `search_voices`: Search through your voice library for a specific voice\n- `get_voice`: Retrieve a specific voice by ID\n- `speech_to_speech`: Transform audio from one voice to another using provided audio files\n- `text_to_voice`: Design a voice via a text prompt\n- `create_voice_from_preview`: Using an ID from `text_to_voice`, save your generated to your library\n- `create_agent`: Create a Conversational AI agent\n- `list_agents`: Retrieve a list of all available Conversational AI agents\n- `get_agent`: Retrieve a specific agent by ID\n- `add_knowledge_base_to_agent`: Add knowledge to your Conversational AI agent. Useful for piping LLM deep research into an agent's knowledge base\n- `make_outbound_call` - Make an outbound call via Twilio using an ElevenLabs agent\n- `list_phone_numbers` - List all phone numbers associated with your ElevenLabs account\n\n- `play_audio`: Play audio directly from the client\n\n## Example Usage\n\nTry asking Claude:\n\n- \"Can you convert this text to speech using a British accent?\"\n- \"What voices are available for text-to-speech?\"\n- \"Can you transcribe this audio file for me?\"\n- \"Generate some rain sound effects\"\n- \"Play that generated voice clip for me\"\n- \"Generate the voice of a jolly giant\"\n\n## Optional features\n\nYou can add the `ELEVENLABS_MCP_BASE_PATH` environment variable to the `claude_desktop_config.json` to specify the base path MCP server should look for and output files specified with relative paths.\n\n## Contributing\n\nIf you want to contribute or run from source:\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/elevenlabs/elevenlabs-mcp-server\ncd elevenlabs-mcp-server\n```\n\n2. Create a virtual environment and install dependencies [using uv](https://github.com/astral-sh/uv):\n\n```bash\nuv venv\nsource .venv/bin/activate\nuv pip install -e \".[dev]\"\n```\n\n3. Copy `.env.example` to `.env` and add your ElevenLabs API key:\n\n```bash\ncp .env.example .env\n# Edit .env and add your API key\n```\n\n4. Run the tests to make sure everything is working:\n\n```bash\n./test.sh\n# Or with options\n./test.sh --verbose --fail-fast\n```\n\n5. Install the server in Claude Desktop: `mcp install elevenlabs_mcp/server.py`\n\n6. Debug and test locally with MCP Inspector: `mcp dev elevenlabs_mcp/server.py`\n\n## Requirements\n\n- Python 3.11 or higher\n- Dependencies:\n - mcp>=0.1.0\n - fastapi==0.109.2\n - uvicorn==0.27.1\n - python-dotenv==1.0.1\n - pydantic>=2.6.1\n - httpx==0.28.1\n - elevenlabs>=1.56.0\n\n## Troubleshooting\n\nLogs when running with Claude Desktop can be found at:\n\n- **Windows**: `%APPDATA%\\Claude\\logs\\mcp-server-elevenlabs.log`\n- **macOS**: `~/Library/Logs/Claude/mcp-server-elevenlabs.log`\n\n### Timeouts when using certain tools\n\nCertain ElevenLabs API operations like voice design and audio isolation can take a long time to resolve. When using the MCP inspector in dev mode you might get timeout errors, despite the tool completing its intended task.\n\nThis shouldn't occur when using a client like Claude.\n",
"bugtrack_url": null,
"license": "MIT License\n \n Copyright (c) 2025 Eleven Labs Inc.\n \n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \"Software\"), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n \n The above copyright notice and this permission notice shall be included in all\n copies or substantial portions of the Software.\n \n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n SOFTWARE.\n ",
"summary": "Eleven Labs MCP Server",
"version": "0.1.8",
"project_urls": null,
"split_keywords": [
"elevenlabs",
" mcp",
" text-to-speech",
" speech-to-text",
" voice-cloning"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d11996f6fc6c9cc486a1b4e6b0458e7f493748aeaef507db7074dfee4bfc4bb5",
"md5": "0399cdc3f1c202d847f00ca6d2eab869",
"sha256": "fd3e922f92f55e269693d3ac5254d0bf79e396ca5ee07bf9dbc203ebfc402f83"
},
"downloads": -1,
"filename": "elevenlabs_mcp-0.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0399cdc3f1c202d847f00ca6d2eab869",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 16947,
"upload_time": "2025-04-07T13:32:37",
"upload_time_iso_8601": "2025-04-07T13:32:37.739097Z",
"url": "https://files.pythonhosted.org/packages/d1/19/96f6fc6c9cc486a1b4e6b0458e7f493748aeaef507db7074dfee4bfc4bb5/elevenlabs_mcp-0.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "94ba485511d4f22e1a1a1796d5f2e5cc1fbce417ebf74d4ee760576f8fd780fd",
"md5": "630d638da45a00d54600e6e09ab2975e",
"sha256": "69b34af5368a564248c6e006ee34c1a800a0dd4cf04500b92c43ffd37d7591f1"
},
"downloads": -1,
"filename": "elevenlabs_mcp-0.1.8.tar.gz",
"has_sig": false,
"md5_digest": "630d638da45a00d54600e6e09ab2975e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 18450,
"upload_time": "2025-04-07T13:32:38",
"upload_time_iso_8601": "2025-04-07T13:32:38.919390Z",
"url": "https://files.pythonhosted.org/packages/94/ba/485511d4f22e1a1a1796d5f2e5cc1fbce417ebf74d4ee760576f8fd780fd/elevenlabs_mcp-0.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-04-07 13:32:38",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "elevenlabs-mcp"
}