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
| 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) |
Input Schema (JSON Schema)
{
"properties": {
"acoustic_ratio_max": {
"description": "Maximum acoustic content ratio (0-1, where 1 is fully acoustic)",
"type": "number"
},
"acoustic_ratio_min": {
"description": "Minimum acoustic content ratio (0-1, where 1 is fully acoustic)",
"type": "number"
},
"actor": {
"description": "Filter by actor/cast member name",
"type": "string"
},
"added_after": {
"description": "Filter items added to library after this date (YYYY-MM-DD format)",
"type": "string"
},
"added_before": {
"description": "Filter items added to library before this date (YYYY-MM-DD format)",
"type": "string"
},
"audio_format": {
"description": "Filter by audio format (for music)",
"enum": [
"lossless",
"lossy",
"mp3",
"flac",
"aac"
],
"type": "string"
},
"bpmMax": {
"description": "Maximum BPM (beats per minute)",
"type": "number"
},
"bpmMin": {
"description": "Minimum BPM (beats per minute)",
"type": "number"
},
"content_rating": {
"description": "Filter by content rating (G, PG, PG-13, R, etc.)",
"type": "string"
},
"director": {
"description": "Filter by director name",
"type": "string"
},
"duration_max": {
"description": "Maximum duration in minutes",
"type": "number"
},
"duration_min": {
"description": "Minimum duration in minutes",
"type": "number"
},
"dynamic_range_max": {
"description": "Maximum dynamic range in dB",
"type": "number"
},
"dynamic_range_min": {
"description": "Minimum dynamic range in dB",
"type": "number"
},
"file_size_max": {
"description": "Maximum file size in MB",
"type": "number"
},
"file_size_min": {
"description": "Minimum file size in MB",
"type": "number"
},
"genre": {
"description": "Filter by genre (e.g., Action, Comedy, Rock, Jazz)",
"type": "string"
},
"last_played_after": {
"description": "Filter items played after this date (YYYY-MM-DD format)",
"type": "string"
},
"last_played_before": {
"description": "Filter items played before this date (YYYY-MM-DD format)",
"type": "string"
},
"limit": {
"default": 10,
"description": "Maximum number of results to return (default: 10)",
"type": "number"
},
"loudness_max": {
"description": "Maximum loudness in LUFS",
"type": "number"
},
"loudness_min": {
"description": "Minimum loudness in LUFS",
"type": "number"
},
"mood": {
"description": "Filter by mood/energy classification",
"enum": [
"energetic",
"calm",
"aggressive",
"melancholic",
"uplifting",
"dark",
"romantic",
"mysterious"
],
"type": "string"
},
"musical_key": {
"description": "Filter by musical key (e.g., 'C', 'G', 'Am', 'F#m')",
"type": "string"
},
"never_played": {
"description": "Filter to only show never played items",
"type": "boolean"
},
"play_count_max": {
"description": "Maximum play count for results",
"type": "number"
},
"play_count_min": {
"description": "Minimum play count for results",
"type": "number"
},
"played_in_last_days": {
"description": "Filter items played in the last N days",
"type": "number"
},
"query": {
"description": "The search query (movie title, show name, etc.)",
"type": "string"
},
"rating_max": {
"description": "Maximum rating (0-10 scale)",
"type": "number"
},
"rating_min": {
"description": "Minimum rating (0-10 scale)",
"type": "number"
},
"resolution": {
"description": "Filter by video resolution",
"enum": [
"4k",
"1080",
"720",
"480",
"sd"
],
"type": "string"
},
"studio": {
"description": "Filter by studio/label (e.g., Warner Bros, Sony Music)",
"type": "string"
},
"type": {
"description": "Type of content to search for (optional)",
"enum": [
"movie",
"show",
"episode",
"artist",
"album",
"track"
],
"type": "string"
},
"writer": {
"description": "Filter by writer name",
"type": "string"
},
"year": {
"description": "Filter by release year",
"type": "number"
},
"year_max": {
"description": "Filter by maximum release year",
"type": "number"
},
"year_min": {
"description": "Filter by minimum release year",
"type": "number"
}
},
"required": [
"query"
],
"type": "object"
}