ElevenLabs MCP server

Read from the package source without running it. The installed server may list more.

• add_pronunciation_dictionary
• archive_pronunciation_dictionary

  Archive a pronunciation dictionary so it is no longer applied to generations. WHEN TO USE: - Retire an outdated or mistaken dictionary - Clean up test dictionaries EXAMPLE: {"pronunciation_dictionary_id": "5xM3yVvZQKV0EfqQpLrJ"} RELATED TOOLS: - list_pronunciation_dictionaries: find dictionary IDs (include_archived shows archived ones) - add_pronunciation_dictionary: create a replacement RETURNS:

• check_subscription

  Check ElevenLabs subscription tier and character credit usage. WHEN TO USE: - Before expensive generation calls (speech, music, sound effects) to confirm credits remain - When a tool returns quota or 403 errors — read remaining characters and next reset - To answer "how much ElevenLabs credit do I have left?" EXAMPLE: {} (no arguments) RELATED TOOLS: - generate_speech, generate_music, generate_sou

• clone_voicewrite action

  Create an instant voice clone from one or more local audio samples. WHEN TO USE: - Clone a speaker from short audio samples the user provides - Add a custom voice to the account for generate_speech or speech_to_speech EXAMPLE: {"name": "My Clone", "files": ["/path/to/sample.mp3"], "description": "Meeting voice"} RELATED TOOLS: - delete_voice: remove a cloned voice when no longer needed (required f

• configure_elevenlabs_api_key

  Host-managed setup only. The user adds the ElevenLabs API key in Settings → Connectors in the app. Do not ask for or accept the key in chat. WHEN TO USE: - Only when the host supplies the key during connector setup EXAMPLE: - Host-managed setup supplies the key directly after the user saves it in Settings → Connectors RELATED TOOLS: - check_subscription: verify the key and see credits after config

• create_dubbingwrite action

  Submit an async dubbing job (v1 API). You MUST poll get_dubbing until status is …. WHEN TO USE: - Translate/dub existing audio or video into another language - Localize a short clip the user already has on disk EXAMPLE: {"file_path": "/path/in/workspace/clip.mp3", "target_lang": "es", "name": "rebel-live-test-dub"} RELATED TOOLS: - get_dubbing: poll job status (every ~10s; respect expected_duratio

• create_music_planwrite action

  Create a composition plan for music generation. WHEN TO USE: - Structure a song with per-section lyrics and styles before paying for generation - Review or edit sections before calling generate_music_from_plan EXAMPLE: {"prompt": "Acoustic folk ballad about the sea", "duration_seconds": 45} RELATED TOOLS: - generate_music_from_plan: generate audio from the returned composition_plan - generate_musi

• create_voice_from_previewwrite action

  Save a voice-design preview as a permanent voice on the account. WHEN TO USE: - After design_voice, when the user picks a preview they want to keep - Promote a generated_voice_id into a reusable voice_id for generate_speech EXAMPLE: {"voice_name": "rebel-live-test-stage4", "voice_description": "calm middle-aged narrator", "generated_voice_id": "abc123fromPreview"} RELATED TOOLS: - design_voice: pr

• delete_dubbingwrite action

  Permanently delete a dubbing job and its outputs. WHEN TO USE: - Cleanup rebel-live-test-* dubbing jobs after live tests - Remove a failed or unwanted dub from the account EXAMPLE: {"dubbing_id": "dub_abc123"} RELATED TOOLS: - create_dubbing / get_dubbing / download_dubbed_audio: the dubbing lifecycle RETURNS: ok confirmation. Irreversible. COST: FREE — no generation; permanently removes the dubbi

• delete_voicewrite action

  Permanently delete a voice from the ElevenLabs account. WHEN TO USE: - Remove a test or temporary cloned voice (e.g. rebel-live-test-* names) - Free a voice slot after clone_voice EXAMPLE: {"voice_id": "abc123voiceId"} RELATED TOOLS: - clone_voice: creates voices that should be deleted after testing - list_voices: confirm the voice is gone RETURNS: ok confirmation. This action is irreversible. COS

• design_voice
• download_dubbed_audio

  Download dubbed audio for a completed dubbing job. WHEN TO USE: - After get_dubbing reports status dubbed - Fetch the localized track for a target language EXAMPLE: {"dubbing_id": "dub_abc123", "language_code": "es"} RELATED TOOLS: - get_dubbing: confirm status is dubbed before downloading - delete_dubbing: cleanup after testing RETURNS: file_path and size_bytes (extension sniffed from Content-Typ

• forced_alignment

  Align a transcript to audio and return per-word timestamps. WHEN TO USE: - Build karaoke-style captions or precise edit markers from audio + transcript - Verify that spoken words match a provided script EXAMPLE: {"file_path": "/path/to/clip.mp3", "text": "Hello world."} RELATED TOOLS: - transcribe_audio: generate transcript text from audio alone - generate_speech: create audio from text (inverse w

• generate_music

  Generate music from a text prompt using ElevenLabs Music API. WHEN TO USE: - Quick music bed from a genre/mood description - Vocal songs when the prompt includes [Verse]/[Chorus] lyric markers (do not set force_instrumental: true) EXAMPLE: {"prompt": "Upbeat jazz piano, 30 seconds", "duration_seconds": 30} RELATED TOOLS: - create_music_plan / generate_music_from_plan: per-section lyrics and styles

• generate_music_from_plan

  Generate music from a composition plan. WHEN TO USE: - After create_music_plan when you want per-section control over lyrics and styles - When generate_music's single prompt is not precise enough EXAMPLE: pass the composition_plan object from create_music_plan verbatim RELATED TOOLS: - create_music_plan: produces the plan shape this tool expects - check_subscription: confirm credits before generat

• generate_sound_effect

  Generate sound effects from a text description. WHEN TO USE: - Short ambient or UI sounds from a natural-language prompt - Effects for video, games, or presentations EXAMPLE: {"prompt": "Soft rain on a tin roof", "duration_seconds": 3} RELATED TOOLS: - check_subscription: confirm credits before generation RETURNS: file_path, size_bytes, duration_seconds. COST: Credits based on duration (0.5–22 sec

• generate_speech

  Generate spoken audio from text using ElevenLabs text-to-speech. WHEN TO USE: - Turn user text into a playable speech file - Narration, voiceovers, or reading content aloud EXAMPLE: {"text": "Hello world.", "voice_id": "21m00Tcm4TlvDq8ikWAM", "model_id": "eleven_v3"} RELATED TOOLS: - list_voices / search_shared_voices / get_voice: find voice_id - list_models: pick model_id (default eleven_v3) - ch

• generate_speech_with_timestamps
• get_dubbing

  Poll dubbing job status. Call repeatedly after create_dubbing until status is …. WHEN TO USE: - After create_dubbing — poll every ~10s (respect expected_duration_sec) - Check whether a dub failed before retrying EXAMPLE: {"dubbing_id": "dub_abc123"} RELATED TOOLS: - create_dubbing: submit the job - download_dubbed_audio: fetch audio when status is dubbed - delete_dubbing: remove test jobs RETURNS:

• get_history_item_audio

  Re-download the audio of a past generation by history_item_id. WHEN TO USE: - After list_history — fetch the audio file of an earlier generation again - Recover audio that was generated in a previous session EXAMPLE: {"history_item_id": "ja9xsmfGhxYcymxGcOGB"} RELATED TOOLS: - list_history: find history_item_id values RETURNS: file_path and size_bytes (extension sniffed from Content-Type). COST: F

• get_pronunciation_dictionary

  Get one pronunciation dictionary's metadata and current rules. WHEN TO USE: - Inspect the rules of a dictionary before adding more or attaching it to a generation - Confirm a brand name is covered EXAMPLE: {"pronunciation_dictionary_id": "5xM3yVvZQKV0EfqQpLrJ"} RELATED TOOLS: - list_pronunciation_dictionaries: find dictionary IDs - add_pronunciation_dictionary: create a new dictionary RETURNS: id,

• get_usage_stats
• get_voice

  Get full details for one voice by voice_id. WHEN TO USE: - Inspect labels, preview URL, and description before generate_speech - Verify a voice_id still exists after a generation error - Compare a voice from list_voices or search_shared_voices in detail EXAMPLE: {"voice_id": "21m00Tcm4TlvDq8ikWAM"} RELATED TOOLS: - list_voices: browse account voices when you do not have the voice_id yet - search_s

• isolate_audiowrite action

  Remove background noise from an audio file (audio isolation). WHEN TO USE: - Clean up meeting recordings or voice memos with background noise - Prepare a cleaner clip before transcription or voice cloning - Source audio is at least ~4.6 seconds long (shorter clips fail upstream) COMMON MISTAKES: - Clips under ~4.6 seconds — the API rejects them; trim/merge or pick a longer sample first EXAMPLE: {"

• list_history

  List previously generated audio items (speech, sound effects, etc.) on this account. WHEN TO USE: - Find a past generation to re-use ("that voiceover from last week") instead of regenerating - Review what text/voice/model a previous generation used EXAMPLE: {"page_size": 10} RELATED TOOLS: - get_history_item_audio: re-download the audio of an item from this list - get_usage_stats: aggregate credit

• list_models

  List ElevenLabs models with languages and capability flags. WHEN TO USE: - Pick a TTS model_id for generate_speech (e.g. eleven_v3, eleven_multilingual_v2) - Verify a model supports the language or capability you need before calling generation tools - Discover model IDs after an invalid model_id error EXAMPLE: {} (no arguments) RELATED TOOLS: - generate_speech: consumes a model_id from this list -

• list_pronunciation_dictionaries

  List pronunciation dictionaries on this account (brand names, jargon, acronyms the TTS voice should pronounce a specific way). WHEN TO USE: - Discover existing pronunciation_dictionary_id values before adding rules or attaching to speech - Check whether a dictionary for a brand or product already exists EXAMPLE: {"page_size": 20} RELATED TOOLS: - get_pronunciation_dictionary: inspect one dictionar

• list_voices

  Search and browse voices on your ElevenLabs account. WHEN TO USE: - Find voice_id values before generate_speech - Filter by category (premade, cloned, generated, professional) - Recover from VOICE_NOT_FOUND by listing what exists on the account EXAMPLE: {"search": "Rachel", "page_size": 5} RELATED TOOLS: - get_voice: full detail for one voice_id from this list - search_shared_voices: browse the pu

• search_shared_voices

  Search the public ElevenLabs shared voice library. WHEN TO USE: - Discover voices beyond those on the user's account - Filter by language, gender, age, or category before cloning or TTS - Find a voice_id when list_voices returns no match EXAMPLE: {"search": "british narrator", "language": "en", "page_size": 10} RELATED TOOLS: - list_voices: voices already on the account (faster for owned voices) -

• speech_to_speech

  Convert an audio clip to sound like a different voice (voice conversion). WHEN TO USE: - Change the speaker voice of an existing recording while preserving timing - Apply a premade or cloned voice_id to source audio the user provides as a file EXAMPLE: {"audio_path": "/path/to/source.mp3", "voice_id": "21m00Tcm4TlvDq8ikWAM"} RELATED TOOLS: - list_voices / get_voice: resolve voice_id - generate_spe

• text_to_dialogue

  Generate multi-voice dialogue audio from a script with one voice per line. WHEN TO USE: - Produce a conversation or script with different speakers - Podcast-style back-and-forth with distinct voices per line EXAMPLE: {"inputs": [{"text": "Hello there.", "voice_id": "21m00Tcm4TlvDq8ikWAM"}, {"text": "Hi!", "voice_id": "pNInz6obpgDQGcFmaJgB"}], "model_id": "eleven_v3"} RELATED TOOLS: - list_voices:

• transcribe_audio

• Code scan59 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 10 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

ElevenLabs: common questions

Is ElevenLabs MCP server safe?

Yes, by our scan: it is graded A (85/100). Read the ElevenLabs safety report

How do I install ElevenLabs?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does ElevenLabs need an API key?

Yes. The registry entry asks for ELEVENLABS_API_KEY.

Is ElevenLabs maintained?

The last commit was 10 days ago (2026-09-13). The latest release is v0.5.2.

What can I use instead of ElevenLabs?

Servers from other publishers that do the same job: Sonilo Music & Sound Effects MCP server, MCP server and ElevenLabs MCP server. Compare all ElevenLabs alternatives.