Generate speech, transcribe audio, create voice agents, compose music, and manage voices using ElevenLabs MCP Server. Use when working with text-to-speech, speech-to-text, voice cloning, conversational AI agents, or music composition.
Generate speech, transcribe audio, create voice agents, compose music, and manage voices using ElevenLabs MCP Server. Use when working with text-to-speech, speech-to-text, voice cloning, conversational AI agents, or music composition.
Generate speech, transcribe audio, create voice agents, compose music, and manage voices using the ElevenLabs MCP Server.
Overview
The ElevenLabs MCP Server provides comprehensive tools for audio generation, transcription, voice management, conversational AI agents, and music composition. Many operations incur API costs - only use when explicitly requested by the user.
Server: ElevenLabs MCP (configured via MCP settings)
Setup
The MCP server is already configured and enabled. You can call these tools directly - they will be available in your tool list.
⚠️ CRITICAL: Cost Warnings
MANY TOOLS INCUR API COSTS - Only use when explicitly requested by the user:
Text-to-Speech (TTS) operations
Speech-to-Text (STT) operations
Voice cloning
Agent creation and conversations
Music composition
Audio processing (isolate, speech-to-speech)
Outbound phone calls
Always check with the user before using cost-incurring tools unless they explicitly request them.
Core Capabilities
Text-to-Speech (TTS)
Convert text to natural-sounding speech
Multiple voice options (search, list, or use voice IDs)
voice_clone - Create instant voice clone from audio files
Agent Tools
create_agent - Create a conversational AI agent
add_knowledge_base_to_agent - Add knowledge base to agent
list_agents - List all your agents
get_agent - Get agent details
get_conversation - Get conversation transcript
list_conversations - List agent conversations
Music Tools
compose_music - Generate music from prompt or composition plan
create_composition_plan - Create structured composition plan
Audio Processing Tools
isolate_audio - Isolate audio from a file
play_audio - Play audio files (WAV, MP3)
Phone Tools
list_phone_numbers - List phone numbers
make_outbound_call - Make outbound call using agent
Utility Tools
list_models - List available TTS models
check_subscription - Check subscription status and usage
Text-to-Speech Workflow
Basic TTS
# Simple text-to-speech
result = text_to_speech(
text="Hello, this is a test of text-to-speech.",
voice_name="Adam", # or use voice_id
output_directory="./output"
)
# Returns file path to generated audio
Voice Selection
You can use either voice_name or voice_id:
# Using voice name
text_to_speech(text="Hello", voice_name="Adam")
# Using voice ID
text_to_speech(text="Hello", voice_id="cgSgspJ2msm6clMCkdW9")
# Search for voices first
voices = search_voices(search="male professional")
voice_id = voices[0]["voice_id"]
text_to_speech(text="Hello", voice_id=voice_id)
Model Selection
Available models:
eleven_multilingual_v2 - High quality multilingual (29 languages)
stability (0-1): Voice stability vs. emotional range (default: 0.5)
similarity_boost (0-1): Adherence to original voice (default: 0.75)
style (0-1): Style exaggeration (default: 0)
use_speaker_boost (bool): Boost similarity to original speaker (default: true)
speed (0.7-1.2): Speech speed (default: 1.0)
output_format: Audio format (default: "mp3_44100_128")
Speech-to-Text Workflow
Basic Transcription
# Transcribe audio file
result = speech_to_text(
input_file_path="./audio/recording.mp3",
save_transcript_to_file=True,
output_directory="./transcripts"
)
# Returns transcript text and saves to file
With Diarization
# Transcribe with speaker identification
result = speech_to_text(
input_file_path="./audio/meeting.mp3",
diarize=True, # Identify different speakers
return_transcript_to_client_directly=True
)
# Returns transcript with speaker annotations
Language Detection
# Automatic language detection (default)
speech_to_text(input_file_path="./audio.mp3")
# Specify language
speech_to_text(
input_file_path="./audio.mp3",
language_code="es"# ISO 639-3 code
)
Voice Cloning Workflow
Clone from Audio Files
# Clone voice from audio samples
result = voice_clone(
name="My Custom Voice",
files=[
"./samples/sample1.mp3",
"./samples/sample2.mp3",
"./samples/sample3.mp3"
],
description="Professional male voice"
)
# Returns voice_id for use in TTS
Create Voice from Text Description
# Generate voice previews
previews = text_to_voice(
voice_description="A warm, friendly female voice with a slight British accent",
text="Hello, this is a preview of the generated voice."
)
# Returns 3 preview variations with generated_voice_id# Add to library
create_voice_from_preview(
generated_voice_id=previews["generated_voice_id"],
voice_name="Friendly British Voice",
voice_description="Warm, friendly female voice with British accent"
)
Agent Creation Workflow
Basic Agent
# Create conversational AI agent
agent = create_agent(
name="Customer Support Agent",
first_message="Hi, how can I help you today?",
system_prompt="You are a helpful customer support agent...",
voice_id="cgSgspJ2msm6clMCkdW9",
language="en"
)
# Returns agent_id
Agent with Knowledge Base
# Create agent first
agent_id = create_agent(...)["agent_id"]
# Add knowledge base
add_knowledge_base_to_agent(
agent_id=agent_id,
knowledge_base_name="Product Documentation",
input_file_path="./docs/product_manual.pdf"
)
# Or add from URL
add_knowledge_base_to_agent(
agent_id=agent_id,
knowledge_base_name="Company Website",
url="https://example.com/docs"
)
# Or add from text
add_knowledge_base_to_agent(
agent_id=agent_id,
knowledge_base_name="FAQ",
text="Q: What is your return policy? A: 30 days..."
)
Making Outbound Calls
# List available phone numbers
phone_numbers = list_phone_numbers()
# Make outbound call
make_outbound_call(
agent_id=agent_id,
agent_phone_number_id=phone_numbers[0]["id"],
to_number="+1234567890"# E.164 format
)
Managing Conversations
# List conversations
conversations = list_conversations(
agent_id=agent_id,
page_size=30
)
# Get conversation transcript
transcript = get_conversation(
conversation_id=conversations[0]["conversation_id"]
)
Music Composition Workflow
Basic Music Generation
# Generate music from prompt
music = compose_music(
prompt="Upbeat electronic dance music with synthesizers",
music_length_ms=60000, # 60 seconds
output_directory="./music"
)
# Returns file path to generated music
Structured Composition Plan
# Create composition plan first
plan = create_composition_plan(
prompt="Epic orchestral piece with multiple movements",
music_length_ms=180000# 3 minutes
)
# Generate music from plan
music = compose_music(
composition_plan=plan,
output_directory="./music"
)
# 1. Search for voice
voices = search_voices(search="professional female")
voice_id = voices[0]["voice_id"]
# 2. Generate speech
audio_file = text_to_speech(
text="Welcome to our application. How can I assist you?",
voice_id=voice_id,
model_id="eleven_turbo_v2_5",
stability=0.5,
similarity_boost=0.75,
speed=1.0,
output_directory="./assets/audio"
)
# 3. Use in application# Reference: audio_file path
Agent with Knowledge Base
# 1. Create agent
agent = create_agent(
name="Product Support",
first_message="Hello! I'm here to help with product questions.",
system_prompt="You are a helpful product support agent...",
voice_id="cgSgspJ2msm6clMCkdW9"
)
agent_id = agent["agent_id"]
# 2. Add knowledge base
add_knowledge_base_to_agent(
agent_id=agent_id,
knowledge_base_name="Product Docs",
input_file_path="./docs/product.pdf"
)
# 3. List conversations later
conversations = list_conversations(agent_id=agent_id)
Music Generation Pipeline
# 1. Create composition plan
plan = create_composition_plan(
prompt="Epic battle music with orchestral and electronic elements",
music_length_ms=120000# 2 minutes
)
# 2. Generate music
music = compose_music(
composition_plan=plan,
output_directory="./assets/music"
)
# 3. Use in game/application# Reference: music file path
Subscription Tiers
Different features require different subscription tiers:
Free Tier: Basic TTS/STT with limitations
Starter Tier: More characters, basic features
Creator Tier: MP3 192kbps, more features
Pro Tier: PCM 44.1kHz, advanced features
Enterprise: Full access, custom solutions
Use check_subscription() to see your current tier and usage limits.