elevenlabs-mcp

Name: elevenlabs-mcp
Author: elevenlabs

byelevenlabs· 1 MCP server

Installs

53k

Stars

1.5k

Forks

249

How to install elevenlabs-mcp?

elevenlabs/elevenlabs-mcp

$git clone https://github.com/elevenlabs/elevenlabs-mcp

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install elevenlabs-mcp by running `git clone https://github.com/elevenlabs/elevenlabs-mcp`, then use it for the current task and follow its documentation at https://github.com/elevenlabs/elevenlabs-mcp.

Files · 1

View on GitHub

README.md

1	![export](https://github.com/user-attachments/assets/ee379feb-348d-48e7-899c-134f7f7cd74f)
2
3	<div class="title-block" style="text-align: center;" align="center">
4
5	[![Discord Community](https://img.shields.io/badge/discord-@elevenlabs-000000.svg?style=for-the-badge&logo=discord&labelColor=000)](https://discord.gg/elevenlabs)
6	[![Twitter](https://img.shields.io/badge/Twitter-@elevenlabsio-000000.svg?style=for-the-badge&logo=twitter&labelColor=000)](https://x.com/ElevenLabsDevs)
7	[![PyPI](https://img.shields.io/badge/PyPI-elevenlabs--mcp-000000.svg?style=for-the-badge&logo=pypi&labelColor=000)](https://pypi.org/project/elevenlabs-mcp)
8	[![Tests](https://img.shields.io/badge/tests-passing-000000.svg?style=for-the-badge&logo=github&labelColor=000)](https://github.com/elevenlabs/elevenlabs-mcp-server/actions/workflows/test.yml)
9
10	</div>
11
12
13	<p align="center">
14	Official ElevenLabs <a href="https://github.com/modelcontextprotocol">Model Context Protocol (MCP)</a> server that enables interaction with powerful Text to Speech and audio processing APIs. This server allows MCP clients like <a href="https://www.anthropic.com/claude">Claude Desktop</a>, <a href="https://www.cursor.so">Cursor</a>, <a href="https://codeium.com/windsurf">Windsurf</a>, <a href="https://github.com/openai/openai-agents-python">OpenAI Agents</a> and others to generate speech, clone voices, transcribe audio, and more.
15	</p>
16
17	<!--
18	mcp-name: io.github.elevenlabs/elevenlabs-mcp
19	-->
20
21	## Quickstart with Claude Desktop
22
23	1. Get your API key from [ElevenLabs](https://elevenlabs.io/app/settings/api-keys). There is a free tier with 10k credits per month.
24	2. Install `uv` (Python package manager), install with `curl -LsSf https://astral.sh/uv/install.sh \| sh` or see the `uv` [repo](https://github.com/astral-sh/uv) for additional install methods.
25	3. Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:
26
27	```
28	{
29	"mcpServers": {
30	"ElevenLabs": {
31	"command": "uvx",
32	"args": ["elevenlabs-mcp"],
33	"env": {
34	"ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
35	}
36	}
37	}
38	}
39
40	```
41
42	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 at the top left and select "Enable Developer Mode".
43
44	## Other MCP clients
45
46	For other clients like Cursor and Windsurf, run:
47	1. `pip install elevenlabs-mcp`
48	2. `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.
49
50	That's it. Your MCP client can now interact with ElevenLabs through these tools:
51
52	## Example usage
53
54	⚠️ Warning: ElevenLabs credits are needed to use these tools.
55
56	Try asking Claude:
57
58	- "Create an AI agent that speaks like a film noir detective and can answer questions about classic movies"
59	- "Generate three voice variations for a wise, ancient dragon character, then I will choose my favorite voice to add to my voice library"
60	- "Convert this recording of my voice to sound like a medieval knight"
61	- "Create a soundscape of a thunderstorm in a dense jungle with animals reacting to the weather"
62	- "Turn this speech into text, identify different speakers, then convert it back using unique voices for each person"
63
64	## Optional features
65
66	### File Output Configuration
67
68	You can configure how the MCP server handles file outputs using these environment variables in your `claude_desktop_config.json`:
69
70	- `ELEVENLABS_MCP_BASE_PATH`: Specify the base path for file operations with relative paths (default: `~/Desktop`)
71	- `ELEVENLABS_MCP_OUTPUT_MODE`: Control how generated files are returned (default: `files`)
72
73	#### Output Modes
74
75	The `ELEVENLABS_MCP_OUTPUT_MODE` environment variable supports three modes:
76
77	1. `files` (default): Save files to disk and return file paths
78	```json
79	"env": {
80	"ELEVENLABS_API_KEY": "your-api-key",
81	"ELEVENLABS_MCP_OUTPUT_MODE": "fi

6 picks

Type

elevenlabs-mcp

How to install elevenlabs-mcp?

Related