elevenlabs-mcp logo

elevenlabs-mcp

by elevenlabs

Official ElevenLabs Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech and audio processing APIs. This server allows MCP clients to generate speech, clone voices, transcribe audio, and more.

View on GitHub

Last updated: N/A

What is elevenlabs-mcp?

The elevenlabs-mcp server is an official implementation of the Model Context Protocol (MCP) by ElevenLabs. It acts as a bridge, allowing MCP-compatible clients to access ElevenLabs' powerful text-to-speech, voice cloning, and audio processing capabilities.

How to use elevenlabs-mcp?

The README provides instructions for integrating with Claude Desktop, Cursor, and Windsurf. Generally, it involves installing the elevenlabs-mcp package, configuring the MCP client with the server's address and your ElevenLabs API key, and then using the client's interface to trigger ElevenLabs features.

Key features of elevenlabs-mcp

  • Text to Speech

  • Voice Cloning

  • Audio Transcription

  • Soundscape Generation

  • Voice Conversion

Use cases of elevenlabs-mcp

  • AI Agents with realistic voices

  • Generating voice variations for characters

  • Converting recordings to different voices

  • Creating soundscapes

  • Transcribing and re-voicing speech with speaker identification

FAQ from elevenlabs-mcp

Where can I find logs when running with Claude Desktop?

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

Why am I getting timeouts when using certain tools in dev mode?

Certain ElevenLabs API operations, like voice design and audio isolation, can take a long time to resolve. This is more likely to occur when using the MCP inspector in dev mode.

What does 'MCP ElevenLabs: spawn uvx ENOENT' mean?

This error indicates that the uvx executable cannot be found. You need to find the absolute path of uvx using which uvx and update your configuration to use that path.

How do I contribute to the project?

Clone the repository, create a virtual environment, install dependencies, copy .env.example to .env and add your ElevenLabs API key, run the tests, and then debug and test locally with MCP Inspector.

How do I specify a base path for file operations?

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.