ElevenLabs MCP Server

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ELEVENLABS_API_KEYYesYour ElevenLabs API key from elevenlabs.io/app/settings/api-keys
ELEVENLABS_MCP_BASE_PATHNoThe base path MCP server should look for and output files specified with relative paths

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
text_to_speech

Convert text to speech with a given voice and save the output audio file to a given directory. Directory is optional, if not provided, the output file will be saved to $HOME/Desktop. Only one of voice_id or voice_name can be provided. If none are provided, the default voice will be used.

⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: text (str): The text to convert to speech. voice_name (str, optional): The name of the voice to use. stability (float, optional): Stability of the generated audio. Determines how stable the voice is and the randomness between each generation. Lower values introduce broader emotional range for the voice. Higher values can result in a monotonous voice with limited emotion. Range is 0 to 1. similarity_boost (float, optional): Similarity boost of the generated audio. Determines how closely the AI should adhere to the original voice when attempting to replicate it. Range is 0 to 1. style (float, optional): Style of the generated audio. Determines the style exaggeration of the voice. This setting attempts to amplify the style of the original speaker. It does consume additional computational resources and might increase latency if set to anything other than 0. Range is 0 to 1. use_speaker_boost (bool, optional): Use speaker boost of the generated audio. This setting boosts the similarity to the original speaker. Using this setting requires a slightly higher computational load, which in turn increases latency. speed (float, optional): Speed of the generated audio. Controls the speed of the generated speech. Values range from 0.7 to 1.2, with 1.0 being the default speed. Lower values create slower, more deliberate speech while higher values produce faster-paced speech. Extreme values can impact the quality of the generated speech. Range is 0.7 to 1.2. output_directory (str, optional): Directory where files should be saved. Defaults to $HOME/Desktop if not provided. Returns: Text content with the path to the output file and name of the voice used.
speech_to_text

Transcribe speech from an audio file and either save the output text file to a given directory or return the text to the client directly.

⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: file_path: Path to the audio file to transcribe language_code: ISO 639-3 language code for transcription (default: "eng" for English) diarize: Whether to diarize the audio file. If True, which speaker is currently speaking will be annotated in the transcription. save_transcript_to_file: Whether to save the transcript to a file. return_transcript_to_client_directly: Whether to return the transcript to the client directly. output_directory: Directory where files should be saved. Defaults to $HOME/Desktop if not provided. Returns: TextContent containing the transcription. If save_transcript_to_file is True, the transcription will be saved to a file in the output directory.
text_to_sound_effects

Convert text description of a sound effect to sound effect with a given duration and save the output audio file to a given directory. Directory is optional, if not provided, the output file will be saved to $HOME/Desktop. Duration must be between 0.5 and 5 seconds.

⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: text: Text description of the sound effect duration_seconds: Duration of the sound effect in seconds output_directory: Directory where files should be saved. Defaults to $HOME/Desktop if not provided.
search_voices
Search for existing voices, a voice that has already been added to the user's ElevenLabs voice library. Searches in name, description, labels and category. Args: search: Search term to filter voices by. Searches in name, description, labels and category. sort: Which field to sort by. `created_at_unix` might not be available for older voices. sort_direction: Sort order, either ascending or descending. Returns: List of voices that match the search criteria.
get_voice

Get details of a specific voice

voice_clone

Clone a voice using provided audio files.

⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user.
isolate_audio

Isolate audio from a file and save the output audio file to a given directory. Directory is optional, if not provided, the output file will be saved to $HOME/Desktop.

⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user.
check_subscription

Check the current subscription status. Could be used to measure the usage of the API.

create_agent

Create a conversational AI agent with custom configuration.

⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: name: Name of the agent first_message: First message the agent will say i.e. "Hi, how can I help you today?" system_prompt: System prompt for the agent voice_id: ID of the voice to use for the agent language: ISO 639-1 language code for the agent llm: LLM to use for the agent temperature: Temperature for the agent. The lower the temperature, the more deterministic the agent's responses will be. Range is 0 to 1. max_tokens: Maximum number of tokens to generate. asr_quality: Quality of the ASR. `high` or `low`. model_id: ID of the ElevenLabsmodel to use for the agent. optimize_streaming_latency: Optimize streaming latency. Range is 0 to 4. stability: Stability for the agent. Range is 0 to 1. similarity_boost: Similarity boost for the agent. Range is 0 to 1. turn_timeout: Timeout for the agent to respond in seconds. Defaults to 7 seconds. max_duration_seconds: Maximum duration of a conversation in seconds. Defaults to 600 seconds (10 minutes). record_voice: Whether to record the agent's voice. retention_days: Number of days to retain the agent's data.
add_knowledge_base_to_agent

Add a knowledge base to ElevenLabs workspace. Allowed types are epub, pdf, docx, txt, html.

⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: agent_id: ID of the agent to add the knowledge base to. knowledge_base_name: Name of the knowledge base. url: URL of the knowledge base. input_file_path: Path to the file to add to the knowledge base. text: Text to add to the knowledge base.
list_agents

List all available conversational AI agents

get_agent

Get details about a specific conversational AI agent

speech_to_speech

Transform audio from one voice to another using provided audio files.

⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user.
text_to_voice

Create voice previews from a text prompt. Creates three previews with slight variations. Saves the previews to a given directory. If no text is provided, the tool will auto-generate text.

Voice preview files are saved as: voice_design_(generated_voice_id)_(timestamp).mp3 Example file name: voice_design_Ya2J5uIa5Pq14DNPsbC1_20250403_164949.mp3 ⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user.
create_voice_from_preview

Add a generated voice to the voice library. Uses the voice ID from the text_to_voice tool.

⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user.
make_outbound_call

Make an outbound call via Twilio using an ElevenLabs agent.

⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs. Only use when explicitly requested by the user. Args: agent_id: The ID of the agent that will handle the call agent_phone_number_id: The ID of the phone number to use for the call to_number: The phone number to call (E.164 format: +1xxxxxxxxxx) Returns: TextContent containing information about the call
search_voice_library

Search for a voice across the entire ElevenLabs voice library.

Args: page: Page number to return (0-indexed) page_size: Number of voices to return per page (1-100) search: Search term to filter voices by Returns: TextContent containing information about the shared voices
list_phone_numbers

List all phone numbers associated with the ElevenLabs account

play_audio

Play an audio file. Supports WAV and MP3 formats.

ID: 98vaqoa894