Inicio rápido con Claude Desktop

Obtén tu clave API en ElevenLabs . Hay un plan gratuito con 10 000 créditos al mes.
Instale uv (administrador de paquetes de Python), instálelo con curl -LsSf https://astral.sh/uv/install.sh | sh o consulte el repositorio uv para obtener métodos de instalación adicionales.
Vaya a Claude > Configuración > Desarrollador > Editar configuración > claude_desktop_config.json para incluir lo siguiente:

{ "mcpServers": { "ElevenLabs": { "command": "uvx", "args": ["elevenlabs-mcp"], "env": { "ELEVENLABS_API_KEY": "<insert-your-api-key-here>" } } } }

Si usa Windows, deberá habilitar el "Modo de desarrollador" en Claude Desktop para usar el servidor MCP. Haga clic en "Ayuda" en el menú de la esquina superior izquierda y seleccione "Habilitar modo de desarrollador".

Related MCP server: ElevenLabs MCP Server

Otros clientes de MCP

Para otros clientes como Cursor y Windsurf, ejecute:

pip install elevenlabs-mcp
python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print para obtener la configuración. Péguela en el directorio de configuración correspondiente especificado por su cliente MCP.

Listo. Tu cliente MCP ahora puede interactuar con ElevenLabs mediante estas herramientas:

Ejemplo de uso

⚠️ Advertencia: Se necesitan créditos de ElevenLabs para utilizar estas herramientas.

Prueba a preguntarle a Claude:

"Crear un agente de IA que hable como un detective de cine negro y pueda responder preguntas sobre películas clásicas".
Genera tres variaciones de voz para un dragón sabio y antiguo. Luego, elegiré mi voz favorita para agregarla a mi biblioteca de voces.
"Convierte esta grabación de mi voz para que suene como la de un caballero medieval"
Crea un paisaje sonoro de una tormenta eléctrica en una selva densa con animales que reaccionan al clima.
"Convierte este discurso en texto, identifica a los diferentes oradores y luego conviértelo de nuevo usando voces únicas para cada persona".

Características opcionales

Puede agregar la variable de entorno ELEVENLABS_MCP_BASE_PATH a claude_desktop_config.json para especificar la ruta base que debe buscar el servidor MCP y los archivos de salida especificados con rutas relativas.

Contribuyendo

Si deseas contribuir o ejecutar desde la fuente:

Clonar el repositorio:

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

Cree un entorno virtual e instale dependencias usando uv :

uv venv source .venv/bin/activate uv pip install -e ".[dev]"

Copie .env.example a .env y agregue su clave API de ElevenLabs:

cp .env.example .env # Edit .env and add your API key

Ejecute las pruebas para asegurarse de que todo funciona:

./scripts/test.sh # Or with options ./scripts/test.sh --verbose --fail-fast

Instalar el servidor en Claude Desktop: mcp install elevenlabs_mcp/server.py
Depure y pruebe localmente con MCP Inspector: mcp dev elevenlabs_mcp/server.py

Solución de problemas

Los registros al ejecutar con Claude Desktop se pueden encontrar en:

Ventanas : %APPDATA%\Claude\logs\mcp-server-elevenlabs.log
macOS : ~/Library/Logs/Claude/mcp-server-elevenlabs.log

Tiempos de espera al utilizar ciertas herramientas

Ciertas operaciones de la API de ElevenLabs, como el diseño de voz y el aislamiento de audio, pueden tardar bastante en resolverse. Al usar el inspector MCP en modo de desarrollo, podrían aparecer errores de tiempo de espera a pesar de que la herramienta complete la tarea prevista.

Esto no debería ocurrir cuando se utiliza un cliente como Claude.

MCP ElevenLabs: engendro uvx ENOENT

Si encuentra el error "MCP ElevenLabs: spawn uvx ENOENT", confirme su ruta absoluta ejecutando este comando en su terminal:

which uvx

Una vez que obtenga la ruta absoluta (p. ej., /usr/local/bin/uvx ), actualice su configuración para usarla (p. ej., "command": "/usr/local/bin/uvx" ). Esto garantiza que se haga referencia al ejecutable correcto.