search_plex
Find movies, TV shows, and music in your Plex libraries using search queries and filters for content type, genre, year, ratings, and playback history.
Instructions
Search for movies, TV shows, and other content in Plex libraries
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The search query (movie title, show name, etc.) | |
| type | No | Type of content to search for (optional) | |
| limit | No | Maximum number of results to return (default: 10) | |
| play_count_min | No | Minimum play count for results | |
| play_count_max | No | Maximum play count for results | |
| last_played_after | No | Filter items played after this date (YYYY-MM-DD format) | |
| last_played_before | No | Filter items played before this date (YYYY-MM-DD format) | |
| played_in_last_days | No | Filter items played in the last N days | |
| never_played | No | Filter to only show never played items | |
| content_rating | No | Filter by content rating (G, PG, PG-13, R, etc.) | |
| resolution | No | Filter by video resolution | |
| audio_format | No | Filter by audio format (for music) | |
| bpmMin | No | Minimum BPM (beats per minute) | |
| bpmMax | No | Maximum BPM (beats per minute) | |
| musical_key | No | Filter by musical key (e.g., 'C', 'G', 'Am', 'F#m') | |
| dynamic_range_min | No | Minimum dynamic range in dB | |
| dynamic_range_max | No | Maximum dynamic range in dB | |
| loudness_min | No | Minimum loudness in LUFS | |
| loudness_max | No | Maximum loudness in LUFS | |
| mood | No | Filter by mood/energy classification | |
| acoustic_ratio_min | No | Minimum acoustic content ratio (0-1, where 1 is fully acoustic) | |
| acoustic_ratio_max | No | Maximum acoustic content ratio (0-1, where 1 is fully acoustic) | |
| file_size_min | No | Minimum file size in MB | |
| file_size_max | No | Maximum file size in MB | |
| genre | No | Filter by genre (e.g., Action, Comedy, Rock, Jazz) | |
| year | No | Filter by release year | |
| year_min | No | Filter by minimum release year | |
| year_max | No | Filter by maximum release year | |
| studio | No | Filter by studio/label (e.g., Warner Bros, Sony Music) | |
| director | No | Filter by director name | |
| writer | No | Filter by writer name | |
| actor | No | Filter by actor/cast member name | |
| rating_min | No | Minimum rating (0-10 scale) | |
| rating_max | No | Maximum rating (0-10 scale) | |
| duration_min | No | Minimum duration in minutes | |
| duration_max | No | Maximum duration in minutes | |
| added_after | No | Filter items added to library after this date (YYYY-MM-DD format) | |
| added_before | No | Filter items added to library before this date (YYYY-MM-DD format) |