What is Elevenlabs Mcp

elevenlabs-mcp is a Model Context Protocol (MCP) server that exposes ElevenLabs API endpoints defined in OpenAPI as MCP resources.

Use cases

Use cases include developing applications that leverage ElevenLabs’ capabilities, such as voice synthesis, text-to-speech, and other AI-driven functionalities.

How to use

To use elevenlabs-mcp, configure it in the Claude Desktop by adding the necessary settings in the configuration file located at ~/Library/Application Support/Claude/claude_desktop_config.json, including your ElevenLabs API key.

Key features

Key features include pre-configuration with ElevenLabs API, support for all ElevenLabs API endpoints, and development tools for building and managing the server.

Where to use

elevenlabs-mcp can be used in software development environments where integration with ElevenLabs API is required, particularly in applications that utilize AI and machine learning.

ElevenLabs MCP Server

A Model Context Protocol (MCP) server that exposes OpenAPI defined ElevenLabs endpoints as MCP resources.

Quick Start

You do not need to clone this repository to use this MCP server. You can simply configure it in Claude Desktop:

1. Locate or create your Claude Desktop configuration file:

   • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the following configuration to enable the OpenAPI MCP server:

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "npx",
      "args": [
        "-y",
        "@angelogiacco/elevenlabs-mcp-server"
      ],
      "env": {
        "ELEVENLABS_API_KEY": "your api key goes here"
      }
    }
  }
}

ElevenLabs API Configuration

This MCP server is pre-configured to work with the ElevenLabs API. To use it:

1. Locate or create your Claude Desktop configuration file:

   • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the following configuration:

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "npx",
      "args": [
        "-y",
        "@angelogiacco/elevenlabs-mcp-server"
      ],
      "env": {
        "ELEVENLABS_API_KEY": "your-elevenlabs-api-key-here"
      }
    }
  }
}

3. Replace your-elevenlabs-api-key-here with your actual ElevenLabs API key.

The server is pre-configured with:

• API Base URL: https://api.elevenlabs.io/
• OpenAPI Spec: https://api.elevenlabs.io/openapi.json
• Server Name: elevenlabs-mcp-server

Available ElevenLabs API Endpoints

The MCP server exposes all ElevenLabs API endpoints available in the openapi spec.

To add new endpoints, just update the openapi spec.

Development Tools

This project includes several development tools to make your workflow easier:

Building

• npm run build - Builds the TypeScript source
• npm run clean - Removes build artifacts
• npm run typecheck - Runs TypeScript type checking

Development Mode

• npm run dev - Watches source files and rebuilds on changes
• npm run inspect-watch - Runs the inspector with auto-reload on changes

Code Quality

• npm run lint - Runs ESLint
• npm run typecheck - Verifies TypeScript types

Configuration

The server can be configured through environment variables or command line arguments:

Development Workflow

1. Start the development environment:

npm run inspect-watch

2. Make changes to the TypeScript files in src/
3. The server will automatically rebuild and restart
4. Use the MCP Inspector UI to test your changes

Debugging

The server outputs debug logs to stderr. To see these logs:

1. In development mode:

   • Logs appear in the terminal running inspect-watch

2. When running directly:

   npm run inspect 2>debug.log
   

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests and linting:

   npm run typecheck
   npm run lint
   

5. Submit a pull request

License

MIT