# ElevenLabs Agents MCP App

Create and manage ElevenLabs conversational AI agents directly from Claude Desktop with an interactive UI.

## Features

- **Interactive Agent Creator**: Visual form-based interface for creating AI agents
- **Voice Selection**: Browse and preview ElevenLabs voices with audio playback
- **Agent Configuration**: Customize personality, language, voice settings, and behavior
- **Edit Existing Agents**: Load and modify existing agent configurations
- **32 Languages Supported**: Create agents in Arabic, Chinese, English, Spanish, and more

## Installation

### Option 1: Install from MCP Directory (Recommended)

Install directly from the Claude Desktop MCP Directory when available and just provide api key.

### Option 2: Manual Installation

1. Clone this repository:
   ```bash
   git clone https://github.com/elevenlabs/elevenlabs-mcp-agent-creator.git
   cd elevenlabs-mcp-agent-creator
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Build the project:
   ```bash
   npm run build:mcpb
   ```

4. Add to Claude Desktop config (`claude_desktop_config.json`):
   ```json
   {
     "mcpServers": {
       "ElevenLabs Agents MCP App": {
         "command": "node",
         "args": ["/path/to/elevenlabs-mcp-agent-creator/server/index.js", "--stdio"],
         "env": {
           "ELEVENLABS_API_KEY": "your-api-key"
         }
       }
     }
   }
   ```

5. Restart Claude Desktop

## Configuration

### Required: ElevenLabs API Key

You need an ElevenLabs API key to use this MCP app:

1. Sign up at [elevenlabs.io](https://elevenlabs.io)
2. Go to [API Keys settings](https://elevenlabs.io/app/settings/api-keys)
3. Create a new API key
4. Add it to your Claude Desktop configuration as shown above

## Usage

### Creating an Agent

Simply ask Claude to create an agent:

- "Create a customer support agent"
- "Make me a friendly booking assistant"
- "Build an AI agent that speaks Spanish"

Claude will open the interactive UI where you can:
- Set the agent name and system prompt
- Choose a voice from ElevenLabs' library
- Select the agent's language
- Adjust voice and behavior settings

### Editing an Agent

To edit an existing agent, provide the agent ID:

- "Edit agent abc123"
- "Update my customer support agent"

### Available Tools

| Tool | Description |
|------|-------------|
| `show_agent_creator` | Opens the interactive agent creation UI |
| `create_agent` | Programmatically creates an agent with specified config |
| `get_agent_config` | Retrieves an existing agent's configuration |
| `update_agent` | Updates an agent's settings |
| `search_voices` | Searches available ElevenLabs voices |

## Agent Settings

### Voice Configuration
- **Voice**: Select from ElevenLabs' voice library with audio preview
- **Stability**: Controls voice consistency (0-1)
- **Similarity Boost**: Controls voice clarity and similarity (0-1)

### Behavior Settings
- **System Prompt**: Define the agent's personality and behavior
- **First Message**: The initial greeting when conversations start
- **Temperature**: Controls response creativity (0-1)
- **Language**: Choose from 32 supported languages

## Development

```bash
# Install dependencies
npm install

# Development mode (with hot reload)
npm run dev

# Build for production
npm run build:mcpb

# Create MCP bundle
npm run pack:mcpb
```

## Privacy

This MCP app connects to the ElevenLabs API. Your API key and agent configurations are sent to ElevenLabs servers. See the [ElevenLabs Privacy Policy](https://elevenlabs.io/privacy) for details on data handling.

## License

MIT License - see [LICENSE](LICENSE) for details.

## Screenshots

<details>
  <summary>Agent Creation UI</summary>

  <img width="1628" alt="ElevenLabs Agents MCP App" src="https://github.com/user-attachments/assets/c1c2b007-9e68-42f0-8c6d-9a9bb08f71da" />

</details>

<details>
  <summary>Agent Created Successfully</summary>

  <img width="1750" alt="Agent Created" src="https://github.com/user-attachments/assets/479d9d31-a323-4b16-9866-5edd0dd05d75" />

</details>