plex_search
Search your Plex media library with keyword, advanced filters, autocomplete suggestions, and saved searches. Retrieve recent searches or save complex filters for future use.
Instructions
Comprehensive search management tool for Plex Media Server.
PORTMANTEAU PATTERN RATIONALE: Consolidates 5 search modalities (text, advanced, suggest, history, persistence) into one tool to provide a unified discovery interface for all media types.
OPERATIONS:
search: Keyword-based text search across libraries.
advanced_search: Multi-parameter Boolean filtering (genre, year, actor, etc.).
suggest: Partial query autocomplete and suggestions.
recent_searches: Retrieve recent session search history.
save_search: Persist complex filters for future recall.
Return Format
{"success": bool, "data": dict|list, "operation": str, "count": int}
Examples
await plex_search(operation="search", query="star wars") await plex_search(operation="advanced_search", genre="comedy", year=2020) await plex_search(operation="suggest", query="incept")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Filter by release year or list of years. | |
| actor | No | Filter by actor name or list. | |
| genre | No | Filter by genre name or list. | |
| limit | No | Maximum number of results to return. | |
| query | No | Search query string for keyword-based searches. | |
| title | No | Filter by exact or partial title. | |
| decade | No | Filter by decade (e.g. 1990 for 1990s). | |
| offset | No | Number of results to skip for pagination. | |
| studio | No | Filter by studio name or list. | |
| country | No | Filter by country of origin or list. | |
| sort_by | No | Sort field (titleSort, year, rating, etc.). | titleSort |
| director | No | Filter by director name or list. | |
| language | No | Filter by audio language or list. | |
| max_year | No | Maximum release year. | |
| min_year | No | Minimum release year. | |
| sort_dir | No | Sort direction: asc or desc. | asc |
| operation | Yes | The search operation to perform. | |
| unwatched | No | Filter to only unwatched items. | |
| collection | No | Filter by collection name or list. | |
| library_id | No | ID of the library to search within. | |
| max_rating | No | Maximum rating threshold (0.0-10.0). | |
| max_recent | No | Maximum number of recent searches to return. | |
| media_type | No | Filter by media type (movie, episode, track). | |
| min_rating | No | Minimum rating threshold (0.0-10.0). | |
| search_name | No | Name to save the search under for future recall. | |
| content_rating | No | Filter by content rating (PG-13, R, etc.) or list. | |
| summary_contains | No | Filter items whose summary contains this text. |