At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
ELEVENLABS_API_KEYis sent as thexi-api-keyheader. - Docs: https://elevenlabs.io/docs/api-reference/authentication
Credentials
Set these per environment. See Connect an integration.| Variable | Required | Description |
|---|---|---|
ELEVENLABS_API_KEY | Yes | ElevenLabs API key from app settings Docs. |
Setup
- Create an ElevenLabs account: Go to https://elevenlabs.io and sign up or sign in. The free tier includes a monthly character allowance suitable for testing.
- Create an API key: Open https://elevenlabs.io/app/settings/api-keys and click ‘Create API Key’. You can restrict the key to specific permissions (e.g. text-to-speech, voices read).
- Store the key: Copy the key and add it to your .env file as ELEVENLABS_API_KEY=…
- Verify access: Run the Get Subscription tool to confirm the key works and see your character quota.
- Authentication uses the xi-api-key header, not Authorization
- Text to Speech returns raw binary audio (application/octet-stream), not JSON - treat the response as a file
- Speech synthesis consumes characters from your plan quota; overages depend on your subscription tier
Tools
| Tool | Access | Description |
|---|---|---|
| List Voices | Read | List and search the voices available to the account |
| Get Voice | Read | Get details about a specific voice |
| List Models | Read | List the speech models available to the account |
| Get Subscription | Read | Get subscription tier, character usage, and limits for the account |
| Text to Speech | Write | Convert text to speech with a chosen voice; the response is binary audio (not JSON), so route the output to a file or player rather than parsing it |
Example prompts
- List my available ElevenLabs voices and summarize them by category.
- Check my ElevenLabs subscription and tell me how much of my character quota is left.