How to add ElevenLabs MCP Server (Official) to Windsurf

Official ElevenLabs server for text-to-speech, voice cloning, sound effects, and audio. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 1.4k★ · stdio · apikey · official

Windsurf config for ElevenLabs MCP Server (Official)

uvx elevenlabs-mcp

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

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the ElevenLabs MCP Server (Official) config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5ElevenLabs MCP Server (Official)'s tools become available to Cascade.

Before you start

An ElevenLabs API key from https://elevenlabs.io/app/settings/api-keys (free tier includes ~10,000 credits/month).
Python with the `uv` package manager (or install via `pip install elevenlabs-mcp`).
An MCP-compatible client (Claude Desktop, Cursor, Windsurf, OpenAI Agents). Windows users must enable Developer Mode in Claude Desktop.
Optional: a microphone/audio setup if you want play_audio; ELEVENLABS_MCP_BASE_PATH to control where generated files land.

What ElevenLabs MCP Server (Official) can do in Windsurf

text_to_speech

Convert text to spoken audio using a chosen voice and model.

speech_to_text

Transcribe an audio file, with optional speaker diarization.

text_to_sound_effects

Generate sound effects from a text description.

speech_to_speech

Transform existing audio to a different target voice.

text_to_voice

Generate three preview voices from a text description.

create_voice_from_preview

Save a generated voice preview into your voice library.

voice_clone

Create an instant voice clone from provided audio samples.

search_voices

Find voices by name, description, labels, or category.

Security

Your ElevenLabs API key can incur usage charges and access your voice library; keep it in env, not in shared configs. The server can write generated audio files to a configurable local path.

ElevenLabs MCP Server (Official) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the ElevenLabs MCP Server (Official) config there under the "mcpServers" key and restart the client.

Is ElevenLabs MCP Server (Official) safe to use with Windsurf?

Your ElevenLabs API key can incur usage charges and access your voice library; keep it in env, not in shared configs. The server can write generated audio files to a configurable local path.

Where do I get the API key and is there a free tier?

Generate it at elevenlabs.io/app/settings/api-keys. The free tier includes roughly 10,000 credits per month, which is enough to test text-to-speech and other tools.

How do I install it — uv or pip?

Both work. `uv` is the recommended path for Claude Desktop; alternatively run `pip install elevenlabs-mcp`. It's a local stdio server, not a hosted remote one.

Where does generated audio go?

By default files are written to your Desktop. Control the location with ELEVENLABS_MCP_BASE_PATH and choose files/resources/both via ELEVENLABS_MCP_OUTPUT_MODE.

View repo Full ElevenLabs MCP Server (Official) page