search_voices
Search your ElevenLabs voice library by name, description, labels, or category to find specific voices for text-to-speech projects.
Instructions
Search for existing voices, a voice that has already been added to the user's ElevenLabs voice library.
Searches in name, description, labels and category.
Args:
search: Search term to filter voices by. Searches in name, description, labels and category.
sort: Which field to sort by. `created_at_unix` might not be available for older voices.
sort_direction: Sort order, either ascending or descending.
Returns:
List of voices that match the search criteria.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | No | ||
| sort | No | name | |
| sort_direction | No | desc |
Implementation Reference
- elevenlabs_mcp/server.py:389-415 (handler)The handler function for the 'search_voices' tool. It uses the ElevenLabs client to search voices based on the provided parameters and returns a list of McpVoice objects.
@mcp.tool( description=""" Search for existing voices, a voice that has already been added to the user's ElevenLabs voice library. Searches in name, description, labels and category. Args: search: Search term to filter voices by. Searches in name, description, labels and category. sort: Which field to sort by. `created_at_unix` might not be available for older voices. sort_direction: Sort order, either ascending or descending. Returns: List of voices that match the search criteria. """ ) def search_voices( search: str | None = None, sort: Literal["created_at_unix", "name"] = "name", sort_direction: Literal["asc", "desc"] = "desc", ) -> list[McpVoice]: response = client.voices.search( search=search, sort=sort, sort_direction=sort_direction ) return [ McpVoice(id=voice.voice_id, name=voice.name, category=voice.category) for voice in response.voices ] - elevenlabs_mcp/model.py:5-10 (schema)Pydantic BaseModel defining the structure of McpVoice, used as the return type for search_voices.
class McpVoice(BaseModel): id: str name: str category: str fine_tuning_status: Optional[Dict] = None - elevenlabs_mcp/server.py:389-389 (registration)The @mcp.tool decorator registers the search_voices function as an MCP tool.
@mcp.tool(