search_voices
Read-only
Search your ElevenLabs voice library by name, description, labels, or category. Filter results and sort by name or creation date to find the voice you need.
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 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- elevenlabs_mcp/server.py:475-486 (handler)The search_voices tool function that calls client.voices.search() and maps results to McpVoice objects.
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/server.py:460-474 (registration)The @mcp.tool decorator that registers search_voices as an MCP tool.
@mcp.tool( annotations=ToolAnnotations(readOnlyHint=True, openWorldHint=True), 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. """ ) - elevenlabs_mcp/model.py:5-9 (schema)The McpVoice Pydantic model used as the return type for search_voices.
class McpVoice(BaseModel): id: str name: str category: str fine_tuning_status: Optional[Dict] = None