ElevenLabs MCP Server

ElevenLabs MCP Server

A complete Model Context Protocol (MCP) server for ElevenLabs Conversational AI, providing seamless integration with agents, tools, and knowledge base management.

Features

• Agent Management: Create, update, delete, and list ElevenLabs conversational AI agents
• Tools Integration: Manage webhook and client-side tools for agent functionality
• Knowledge Base: Handle document upload, URL scraping, and text-based knowledge sources
• RAG Support: Compute and manage Retrieval-Augmented Generation indices
• Real-time Updates: Subscribe to resource changes and notifications
• Claude Desktop Integration: Easy setup for Claude Desktop users
• Cloud Deployment: Docker container ready for remote deployment

Installation

Local Development

1. Clone the repository:

git clone https://github.com/anthropics/elevenlabs-mcp-server.git
cd elevenlabs-mcp-server

2. Install dependencies:

pip install -r requirements.txt

3. Set up environment variables:

cp .env.example .env
# Edit .env with your ElevenLabs API key

4. Install the package:

pip install -e .

Production Installation

pip install elevenlabs-mcp-server

Configuration

Environment Variables

Create a .env file with the following variables:

ELEVENLABS_API_KEY=your-elevenlabs-api-key-here
ELEVENLABS_BASE_URL=https://api.elevenlabs.io/v1
MCP_SERVER_NAME=elevenlabs-mcp-server
MCP_SERVER_VERSION=1.0.0
REQUEST_TIMEOUT=30
MAX_RETRIES=3
LOG_LEVEL=INFO

Claude Desktop Integration

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "elevenlabs": {
      "command": "python",
      "args": ["-m", "elevenlabs_mcp.server"],
      "env": {
        "ELEVENLABS_API_KEY": "your-elevenlabs-api-key-here"
      }
    }
  }
}

Usage

Starting the Server

# Using the installed command
elevenlabs-mcp-server

# Or using Python module
python -m elevenlabs_mcp.server

Available Tools

Agent Management

• create_agent: Create a new conversational AI agent
• get_agent: Retrieve agent configuration by ID
• list_agents: List all agents with pagination
• update_agent: Update existing agent configuration
• delete_agent: Delete an agent

Tool Management

• create_tool: Create webhook or client-side tools
• get_tool: Retrieve tool configuration by ID
• list_tools: List all tools with optional filtering
• update_tool: Update existing tool configuration
• delete_tool: Delete a tool

Knowledge Base Management

• create_knowledge_base_from_text: Create knowledge base from text content
• create_knowledge_base_from_url: Create knowledge base from URL scraping
• get_knowledge_base_document: Retrieve document details
• list_knowledge_base_documents: List all knowledge base documents
• update_knowledge_base_document: Update document metadata
• delete_knowledge_base_document: Delete a document
• compute_rag_index: Compute RAG index for enhanced retrieval
• get_document_content: Get full document content and chunks

Example Usage

Creating an Agent

{
  "conversation_config": {
    "agent": {
      "language": "en",
      "prompt": {
        "prompt": "You are a helpful customer service agent.",
        "built_in_tools": ["language_detection", "end_call"]
      },
      "first_message": "Hello! How can I help you today?"
    },
    "asr": {
      "quality": "high",
      "provider": "elevenlabs"
    },
    "tts": {
      "model_id": "eleven_turbo_v2",
      "voice_id": "21m00Tcm4TlvDq8ikWAM"
    }
  },
  "name": "Customer Service Agent"
}

Creating a Webhook Tool

{
  "tool_type": "webhook",
  "name": "weather_lookup",
  "description": "Get current weather information",
  "url": "https://api.weather.com/v1/current",
  "method": "GET",
  "parameters": [
    {
      "name": "location",
      "type": "string",
      "description": "City name for weather lookup",
      "required": true
    }
  ]
}

Creating Knowledge Base from Text

{
  "text": "This is important company information about our products...",
  "name": "Company Product Guide",
  "description": "Comprehensive guide to our product offerings"
}

Resources

The server exposes the following MCP resources:

• elevenlabs://agents: List all agents
• elevenlabs://tools: List all tools
• elevenlabs://knowledge-base: List all knowledge base documents

Cloud Deployment

Docker

1. Build the Docker image:

docker build -t elevenlabs-mcp-server .

2. Run the container:

docker run -e ELEVENLABS_API_KEY=your-api-key elevenlabs-mcp-server

Docker Compose

version: '3.8'
services:
  elevenlabs-mcp:
    build: .
    environment:
      - ELEVENLABS_API_KEY=your-api-