How to add ElevenLabs MCP Server (Official) to Cursor

Official ElevenLabs server for text-to-speech, voice cloning, sound effects, and audio. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the ElevenLabs MCP Server (Official) config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of ElevenLabs MCP Server (Official)'s tools to confirm it's connected.

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 Cursor

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) + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.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 Cursor?

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