# ElevenLabs Agents

Connects your coding assistant to ElevenLabs Conversational AI to manage voice agents, launch calls, and update knowledge bases. Useful when building telephony workflows.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Author: mindstone
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mindstone/mcp-servers/tree/HEAD/connectors/elevenlabs-agents
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/elevenlabs-agents

## What it does

This server exposes 31 tools that interface with the ElevenLabs ConvAI API. It handles creating and updating voice agents, along with testing their responses via simulation before deployment. You can also attach webhook tools to an agent workspace.

Telephony features cover phone number management and call dispatching. You can import external numbers, trigger outbound calls, or monitor scheduled batch jobs. The server also uploads documents from local files or URLs into the knowledge base. Fetched document content is capped at roughly 50KB.

Running this package requires Node.js 20+. You also need an `ELEVENLABS_API_KEY` with Conversational AI access. Without this specific permission, API requests fail immediately. The server encloses all caller transcripts in `<untrusted-content>` envelopes to prevent prompt injection.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ELEVENLABS_API_KEY`, `MCP_WORKSPACE_PATH` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ELEVENLABS_API_KEY=<ELEVENLABS_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --transport stdio elevenlabs-agents -- npx -y @mindstone/mcp-server-elevenlabs-agents
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add elevenlabs-agents --env ELEVENLABS_API_KEY=<ELEVENLABS_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> -- npx -y @mindstone/mcp-server-elevenlabs-agents
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "elevenlabs-agents": {
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-elevenlabs-agents"
            ],
            "env": {
                "ELEVENLABS_API_KEY": "<ELEVENLABS_API_KEY>",
                "MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "elevenlabs-agents": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-elevenlabs-agents"
            ],
            "env": {
                "ELEVENLABS_API_KEY": "<ELEVENLABS_API_KEY>",
                "MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ELEVENLABS_API_KEY=<ELEVENLABS_API_KEY> -e MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> elevenlabs-agents npx -y @mindstone/mcp-server-elevenlabs-agents
```
Replace <…> with your own values

## When to use it
- build and simulate conversational voice agents
- import telephone numbers from Twilio or SIP trunks
- dispatch outbound calls and scheduled batch campaigns
- retrieve conversation transcripts and recorded call audio
- upload documents or URLs into the RAG knowledge base

## Example prompts
- List all available voice agents in the ElevenLabs workspace
- Run a simulated conversation for agent `support-bot` with the prompt 'How do I cancel my subscription?'
- Add `pricing.md` to the knowledge base and verify its RAG index status

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

From the same set: [mindstone/mcp-servers](https://affpapa.org/en/nevibecode/by/mindstone/mcp-servers.md) — 40 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md