ElevenLabs
Connect ElevenLabs to turn text into speech, design and clone voices, transcribe and dub audio, and build voice agents.
You end up pasting a single ElevenLabs API key, the sk_... string sent as the xi-api-key header, into PopMCP. That is the only field.
- Setup time
- 3 min
- Auth
- API credentials
- API base URL
- https://api.elevenlabs.io/v1
- Rate limits
- ElevenLabs throttles by concurrent requests rather than a fixed calls-per-minute quota. The concurrency ceiling rises with your subscription tier.
Before you begin
- An ElevenLabs account on any plan, including Free
- A Full Seat on the workspace, which is what personal API key creation requires
- For a key that survives people leaving the team, a multi-seat plan plus workspace admin rights so you can create a service account key instead
Get your credentials
Open your API keys settings
Sign in at elevenlabs.io, click your profile icon in the top right and choose Settings, then open API Keys. The direct link is elevenlabs.io/app/settings/api-keys.
API Keys
Keys that authenticate requests against this workspace's quota.
| Name | Key | Scopes | Expires | Created |
|---|---|---|---|---|
| Local scriptsPersonal key | sk_****9f13 | All | Never | Mar 4, 2026 |
| Old integrationPersonal key | sk_****21c7 | Restricted | Apr 1, 2026 | Jan 9, 2026 |
The Expires column shows when each key lapses.
Create a key for PopMCP
Click Create API Key, name it PopMCP, and leave Expire After on Never. Leave the scope and IP restrictions switched off.
API Keys
Keys that authenticate requests against this workspace's quota.
Scope restrictions set here are what produce missing_permissions errors later.
Copy the key before closing the dialog
Copy the sk_ string straight away, ElevenLabs shows the full key only once.
API Keys
Keys that authenticate requests against this workspace's quota.
The list shows only a masked value afterwards.
Paste it into PopMCP
In PopMCP paste the key into API key and click Connect.
Optional: use a service account key instead
For a key that outlives one person, click your profile icon, choose Workspace settings and open the Service Accounts tab. Create a key there and paste that one into PopMCP.
Connect in PopMCP
Open your workspace, choose ElevenLabs in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API keysecret | ElevenLabs dashboard → Settings → API Keys → Create/Copy. Stored encrypted; used server-side only (sent in the xi-api-key header). The connection is locked to this key's workspace.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against ElevenLabs immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
The ElevenLabs card in PopMCP shows Connected with your workspace name, and a test 'list voices' call returns your voice library.
Troubleshooting
401 Unauthorized
Why: The key was truncated on copy, it was revoked, or it passed its Expire After date.
Fix: Create a fresh key under Settings → API Keys with Expire After set to Never, then paste the complete sk_ string.
missing_permissions on some tools only
Why: The key was created with endpoint scope restrictions.
Fix: Create a new key with restrictions turned off, or add the specific scopes the failing tools need.
403 on every call from your server
Why: The key has an IP allowlist that does not cover the calling host.
Fix: Edit the key and add the caller's public IP or CIDR range, or remove the allowlist.
quota_exceeded
Why: The key hit its credit quota, or the workspace ran out of characters for the month.
Fix: Raise or clear the key's credit quota on the API Keys page, or top up the plan.
The key was disabled without you doing anything
Why: GitHub secret scanning found the key in a public repository and ElevenLabs disabled it, reporting disable_reason exposed_publicly.
Fix: Create a replacement key, update PopMCP, and remove the leaked key from the repository history.
401 detected_unusual_activity
Why: ElevenLabs blocks Free-tier API traffic it flags as abusive, commonly from VPN, proxy or datacentre IPs.
Fix: Upgrade the workspace to any paid plan, then reconnect.