{"id":27671527,"url":"https://github.com/elevenlabs/elevenlabs-mcp","last_synced_at":"2026-01-06T11:21:26.647Z","repository":{"id":286646242,"uuid":"948516412","full_name":"elevenlabs/elevenlabs-mcp","owner":"elevenlabs","description":"The official ElevenLabs MCP server","archived":false,"fork":false,"pushed_at":"2025-04-07T16:09:08.000Z","size":332,"stargazers_count":13,"open_issues_count":0,"forks_count":0,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-04-07T17:24:27.865Z","etag":null,"topics":["elevenlabs","elevenlabs-api","mcp"],"latest_commit_sha":null,"homepage":"https://elevenlabs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elevenlabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-14T13:28:17.000Z","updated_at":"2025-04-07T17:02:42.000Z","dependencies_parsed_at":"2025-04-09T09:46:42.659Z","dependency_job_id":null,"html_url":"https://github.com/elevenlabs/elevenlabs-mcp","commit_stats":null,"previous_names":["elevenlabs/elevenlabs-mcp"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elevenlabs%2Felevenlabs-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elevenlabs%2Felevenlabs-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elevenlabs%2Felevenlabs-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elevenlabs%2Felevenlabs-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elevenlabs","download_url":"https://codeload.github.com/elevenlabs/elevenlabs-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250729110,"owners_count":21477606,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["elevenlabs","elevenlabs-api","mcp"],"created_at":"2025-04-24T23:36:59.413Z","updated_at":"2026-01-06T11:21:26.642Z","avatar_url":"https://github.com/elevenlabs.png","language":"Python","funding_links":[],"categories":["Media Processing","Media Processing MCP Servers","Medien und Unterhaltung","MCP Servers","MCP Servers for Creative Work","📚 Projects (1974 total)","📦 Other","Content Creation","Voice MCP \u0026 Coding Agent Voice | 语音 MCP 与编程 Agent 语音","Official Servers","Python","官方 MCP 服务器列表","HarmonyOS","Other Tools and Integrations","AI and Agents","MCP Ecosystem","MCP Servers \u0026 Protocol","Other (143 servers)","MCP 服务器精选列表"],"sub_categories":["Audio \u0026 Music","Claude API","Dieselbe Konfiguration, CLI und IDE","Media \u0026 Creativity","Image, Video, Audio Generation","MCP Servers","Voice MCP Servers | 语音 MCP 服务","Windows Manager","How to Submit","Servers","multimedia 多媒体与内容创作"],"readme":"![export](https://github.com/user-attachments/assets/ee379feb-348d-48e7-899c-134f7f7cd74f)\n\n\u003cdiv class=\"title-block\" style=\"text-align: center;\" align=\"center\"\u003e\n\n  [![Discord Community](https://img.shields.io/badge/discord-@elevenlabs-000000.svg?style=for-the-badge\u0026logo=discord\u0026labelColor=000)](https://discord.gg/elevenlabs)\n  [![Twitter](https://img.shields.io/badge/Twitter-@elevenlabsio-000000.svg?style=for-the-badge\u0026logo=twitter\u0026labelColor=000)](https://x.com/ElevenLabsDevs)\n  [![PyPI](https://img.shields.io/badge/PyPI-elevenlabs--mcp-000000.svg?style=for-the-badge\u0026logo=pypi\u0026labelColor=000)](https://pypi.org/project/elevenlabs-mcp)\n  [![Tests](https://img.shields.io/badge/tests-passing-000000.svg?style=for-the-badge\u0026logo=github\u0026labelColor=000)](https://github.com/elevenlabs/elevenlabs-mcp-server/actions/workflows/test.yml)\n\n\u003c/div\u003e\n\n\n\u003cp align=\"center\"\u003e\n  Official ElevenLabs \u003ca href=\"https://github.com/modelcontextprotocol\"\u003eModel Context Protocol (MCP)\u003c/a\u003e server that enables interaction with powerful Text to Speech and audio processing APIs. This server allows MCP clients like \u003ca href=\"https://www.anthropic.com/claude\"\u003eClaude Desktop\u003c/a\u003e, \u003ca href=\"https://www.cursor.so\"\u003eCursor\u003c/a\u003e, \u003ca href=\"https://codeium.com/windsurf\"\u003eWindsurf\u003c/a\u003e, \u003ca href=\"https://github.com/openai/openai-agents-python\"\u003eOpenAI Agents\u003c/a\u003e and others to generate speech, clone voices, transcribe audio, and more.\n\u003c/p\u003e\n\n\u003c!--\nmcp-name: io.github.elevenlabs/elevenlabs-mcp\n--\u003e\n\n## Quickstart with Claude Desktop\n\n1. Get your API key from [ElevenLabs](https://elevenlabs.io/app/settings/api-keys). There is a free tier with 10k credits per month.\n2. Install `uv` (Python package manager), install with `curl -LsSf https://astral.sh/uv/install.sh | sh` or see the `uv` [repo](https://github.com/astral-sh/uv) for additional install methods.\n3. Go to Claude \u003e Settings \u003e Developer \u003e Edit Config \u003e claude_desktop_config.json to include the following:\n\n```\n{\n  \"mcpServers\": {\n    \"ElevenLabs\": {\n      \"command\": \"uvx\",\n      \"args\": [\"elevenlabs-mcp\"],\n      \"env\": {\n        \"ELEVENLABS_API_KEY\": \"\u003cinsert-your-api-key-here\u003e\"\n      }\n    }\n  }\n}\n\n```\n\nIf you're using Windows, you will have to enable \"Developer Mode\" in Claude Desktop to use the MCP server. Click \"Help\" in the hamburger menu at the top left and select \"Enable Developer Mode\".\n\n## Other MCP clients\n\nFor other clients like Cursor and Windsurf, run:\n1. `pip install elevenlabs-mcp`\n2. `python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print` to get the configuration. Paste it into appropriate configuration directory specified by your MCP client.\n\nThat's it. Your MCP client can now interact with ElevenLabs through these tools:\n\n## Example usage\n\n⚠️ Warning: ElevenLabs credits are needed to use these tools.\n\nTry asking Claude:\n\n- \"Create an AI agent that speaks like a film noir detective and can answer questions about classic movies\"\n- \"Generate three voice variations for a wise, ancient dragon character, then I will choose my favorite voice to add to my voice library\"\n- \"Convert this recording of my voice to sound like a medieval knight\"\n- \"Create a soundscape of a thunderstorm in a dense jungle with animals reacting to the weather\"\n- \"Turn this speech into text, identify different speakers, then convert it back using unique voices for each person\"\n\n## Optional features\n\n### File Output Configuration\n\nYou can configure how the MCP server handles file outputs using these environment variables in your `claude_desktop_config.json`:\n\n- **`ELEVENLABS_MCP_BASE_PATH`**: Specify the base path for file operations with relative paths (default: `~/Desktop`)\n- **`ELEVENLABS_MCP_OUTPUT_MODE`**: Control how generated files are returned (default: `files`)\n\n#### Output Modes\n\nThe `ELEVENLABS_MCP_OUTPUT_MODE` environment variable supports three modes:\n\n1. **`files`** (default): Save files to disk and return file paths\n   ```json\n   \"env\": {\n     \"ELEVENLABS_API_KEY\": \"your-api-key\",\n     \"ELEVENLABS_MCP_OUTPUT_MODE\": \"files\"\n   }\n   ```\n\n2. **`resources`**: Return files as MCP resources; binary data is base64-encoded, text is returned as UTF-8 text\n   ```json\n   \"env\": {\n     \"ELEVENLABS_API_KEY\": \"your-api-key\",\n     \"ELEVENLABS_MCP_OUTPUT_MODE\": \"resources\"\n   }\n   ```\n\n3. **`both`**: Save files to disk AND return as MCP resources\n   ```json\n   \"env\": {\n     \"ELEVENLABS_API_KEY\": \"your-api-key\",\n     \"ELEVENLABS_MCP_OUTPUT_MODE\": \"both\"\n   }\n   ```\n\n**Resource Mode Benefits:**\n- Files are returned directly in the MCP response as base64-encoded data\n- No disk I/O required - useful for containerized or serverless environments\n- MCP clients can access file content immediately without file system access\n- In `both` mode, resources can be fetched later using the `elevenlabs://filename` URI pattern\n\n**Use Cases:**\n- `files`: Traditional file-based workflows, local development\n- `resources`: Cloud environments, MCP clients without file system access\n- `both`: Maximum flexibility, caching, and resource sharing scenarios\n\n### Data residency keys\n\nYou can specify the data residency region with the `ELEVENLABS_API_RESIDENCY` environment variable. Defaults to `\"us\"`.\n\n**Note:** Data residency is an enterprise only feature. See [the docs](https://elevenlabs.io/docs/product-guides/administration/data-residency#overview) for more details.\n\n## Contributing\n\nIf you want to contribute or run from source:\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/elevenlabs/elevenlabs-mcp\ncd elevenlabs-mcp\n```\n\n2. Create a virtual environment and install dependencies [using uv](https://github.com/astral-sh/uv):\n\n```bash\nuv venv\nsource .venv/bin/activate\nuv pip install -e \".[dev]\"\n```\n\n3. Copy `.env.example` to `.env` and add your ElevenLabs API key:\n\n```bash\ncp .env.example .env\n# Edit .env and add your API key\n```\n\n4. Run the tests to make sure everything is working:\n\n```bash\n./scripts/test.sh\n# Or with options\n./scripts/test.sh --verbose --fail-fast\n```\n\n5. Install the server in Claude Desktop: `mcp install elevenlabs_mcp/server.py`\n\n6. Debug and test locally with MCP Inspector: `mcp dev elevenlabs_mcp/server.py`\n\n## Troubleshooting\n\nLogs when running with Claude Desktop can be found at:\n\n- **Windows**: `%APPDATA%\\Claude\\logs\\mcp-server-elevenlabs.log`\n- **macOS**: `~/Library/Logs/Claude/mcp-server-elevenlabs.log`\n\n### Timeouts when using certain tools\n\nCertain ElevenLabs API operations, like voice design and audio isolation, can take a long time to resolve. When using the MCP inspector in dev mode, you might get timeout errors despite the tool completing its intended task.\n\nThis shouldn't occur when using a client like Claude.\n\n### MCP ElevenLabs: spawn uvx ENOENT\n\nIf you encounter the error \"MCP ElevenLabs: spawn uvx ENOENT\", confirm its absolute path by running this command in your terminal:\n\n```bash\nwhich uvx\n```\n\nOnce you obtain the absolute path (e.g., `/usr/local/bin/uvx`), update your configuration to use that path (e.g., `\"command\": \"/usr/local/bin/uvx\"`). This ensures that the correct executable is referenced.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felevenlabs%2Felevenlabs-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felevenlabs%2Felevenlabs-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felevenlabs%2Felevenlabs-mcp/lists"}