◆PromptShop

ElevenLabs Automation

AutomationAuto-detects your installed agents and installs the skill to each one.

Install

npx promptshop add ElevenLabs

Details

AutomationAuto-detects your installed agents and installs the skill to each one.

What This Skill Does

  • This skill automates text-to-speech workflows using ElevenLabs, allowing users to convert text to natural-sounding speech, browse voices, and manage audio generation.
  • It's designed for developers and content creators who need to programmatically generate audio.
  • The skill requires an ElevenLabs account and API key.

When to Use

  • Generate speech from text programmatically.
  • Browse available voices in the ElevenLabs library.
  • Inspect voice details and characteristics.
  • Check ElevenLabs subscription credits.
  • Stream audio for low-latency delivery.
  • Retrieve previously generated audio from history.

Key Features

  • Converts text to speech using ELEVENLABS_TEXT_TO_SPEECH.
  • Provides access to various output formats (MP3, PCM, uLaw).
  • Allows browsing of available voices using ELEVENLABS_GET_VOICES.
  • Supports streaming audio with optimized latency.
  • Offers control over voice settings and models.
  • Provides access to previously generated audio.

Manual Installation

ElevenLabs Automation

Automate your ElevenLabs text-to-speech workflows -- convert text to natural speech, browse the voice library, inspect voice details, check subscription credits, select TTS models, stream audio for low-latency delivery, and retrieve previously generated audio from history.

Toolkit docs: composio.dev/toolkits/elevenlabs

Setup

Add the Composio MCP server to your client: https://rube.app/mcp Connect your ElevenLabs account when prompted (API key authentication) Start using the workflows below

Core Workflows

1. Generate Speech from Text

Use ELEVENLABS_TEXT_TO_SPEECH to convert text into a downloadable audio file.

Tool: ELEVENLABS_TEXT_TO_SPEECH Inputs:

  • voice_id: string (required) -- obtain from ELEVENLABS_GET_VOICES
  • text: string (required) -- max ~10,000 chars (most models), 30,000 (Flash/Turbo v2), 40,000 (v2.5)
  • model_id: string (default "eleven_monolingual_v1") -- e.g., "eleven_multilingual_v2"
  • output_format: string (default "mp3_44100_128") -- see formats below
  • optimize_streaming_latency: integer (0-4; NOT supported with eleven_v3)
  • seed: integer (optional, for reproducibility -- not guaranteed)
  • pronunciation_dictionary_locators: array (optional, up to 3 dictionaries)

Output formats: MP3: mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192 (Creator+) PCM: pcm_16000, pcm_22050, pcm_24000, pcm_44100 (Pro+) uLaw: ulaw_8000 (for Twilio)

  • Important: Output is a file object with a presigned download link at data.
  • file.
  • s3url (expires in ~1 hour).
  • Download promptly.

2. Browse Available Voices

Use ELEVENLABS_GET_VOICES to list all voices with their attributes and settings.

Tool: ELEVENLABS_GET_VOICES Inputs: (none)

  • Returns an array at data.
  • voices[] with voice_id, name, labels (gender, accent, use_case), and settings.

3. Inspect a Specific Voice

Use ELEVENLABS_GET_VOICE to get detailed metadata for a candidate voice before synthesis.

Tool: ELEVENLABS_GET_VOICE Inputs:

  • voice_id: string (required) -- e.g., "21m00Tcm4TlvDq8ikWAM"
  • with_settings: boolean (default false) -- include detailed voice settings

4. Check Subscription and Credits

Use ELEVENLABS_GET_USER_SUBSCRIPTION_INFO to verify plan limits and remaining credits before bulk generation.

Tool: ELEVENLABS_GET_USER_SUBSCRIPTION_INFO Inputs: (none)

5. List Available TTS Models

Use ELEVENLABS_GET_MODELS to discover compatible models and filter by can_do_text_to_speech: true.

Tool: ELEVENLABS_GET_MODELS Inputs: (none)

6. Stream Audio and Retrieve History

Use ELEVENLABS_TEXT_TO_SPEECH_STREAM for low-latency streamed delivery, and ELEVENLABS_GET_AUDIO_FROM_HISTORY_ITEM to re-download previously generated audio.

Tool: ELEVENLABS_TEXT_TO_SPEECH_STREAM

  • Same core inputs as TEXT_TO_SPEECH but returns a stream for low-latency playback

Tool: ELEVENLABS_GET_AUDIO_FROM_HISTORY_ITEM

  • history_item_id: string (required) -- ID from a previous generation

Known Pitfalls

PitfallDetail
Text length limitsMost models cap at ~10,000-20,000 chars per request. Oversized input returns HTTP 400. Split long text into chunks (~5000 chars) and generate per chunk.
Output is a presigned URLELEVENLABS_TEXT_TO_SPEECH returns data.file.s3url with a ~1 hour expiry (X-Amz-Expires=3600). Download the audio file promptly.
Quota and credit errorsHTTP 401 with quota_exceeded or HTTP 402 payment_required means insufficient credits or tier restrictions. Check with ELEVENLABS_GET_USER_SUBSCRIPTION_INFO before bulk jobs.
Voice permissionsHTTP 401 with missing_permissions means the API key lacks voices_read scope. Verify key permissions.
Model compatibilityNot all models support TTS. Use ELEVENLABS_GET_MODELS and filter by can_do_text_to_speech: true. The optimize_streaming_latency parameter is NOT supported with eleven_v3.
Large voice list truncationELEVENLABS_GET_VOICES may return a large list. Select from the full data.voices[] payload -- previews may appear truncated.

Quick Reference

Tool SlugDescription
ELEVENLABS_TEXT_TO_SPEECHConvert text to speech, returns downloadable audio file
ELEVENLABS_GET_VOICESList all available voices with attributes
ELEVENLABS_GET_VOICEGet detailed info for a specific voice
ELEVENLABS_GET_USER_SUBSCRIPTION_INFOCheck subscription plan and remaining credits
ELEVENLABS_GET_MODELSList available TTS models and capabilities
ELEVENLABS_TEXT_TO_SPEECH_STREAMStream audio for low-latency delivery
ELEVENLABS_GET_AUDIO_FROM_HISTORY_ITEMRe-download audio from generation history

Tool: ELEVENLABS_GET_VOICE Inputs:

  • voice_id: string (required) -- e.g., "21m00Tcm4TlvDq8ikWAM"
  • with_settings: boolean (default false) -- include detailed voice setting