Random pick
random_pickPick N random items from a Plex library using filters like genre, decade, duration, and watched state—default 3—to solve 'just pick something' choices.
Instructions
N random items matching the same filters as list_media (the 'just pick something' tool). Defaults to 3 picks. Combine watched=unwatched with genre, decade, maxDurationMin etc. user picks as a Plex Home user, so unwatched means unwatched by them. collection with no kind picks the kind the collection holds. Each pick is the record list_media returns (title, year, watched state, genres, duration and so on). detail=true adds fields such as directors, actors, collections and summaries so you can explain the pick. The result's filters object names what each genre/collection/country/studio/label filter matched: the same name ignoring case first, else the first one containing it.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "random_pick"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | ||
| user | No | see the library as this Plex Home user (name or id) | |
| year | No | ||
| count | No | ||
| genre | No | ||
| label | No | filter to items carrying this Plex label. Plex lists every label on the server under every library, so a label used only in another library returns no items rather than an error | |
| rated | No | all | |
| decade | No | e.g. '1970s' | |
| detail | No | ||
| studio | No | ||
| country | No | ||
| library | No | Movies | |
| watched | No | all | |
| addedSince | No | ISO date or relative like '-30d' | |
| collection | No | filter to members of a collection. Leaving kind out uses the kind of item the collection holds. A smart collection with no tag is an error naming the ratingKey to pass to get_children | |
| contentRating | No | e.g. 'PG-13' | |
| maxDurationMin | No | ||
| lastViewedAfter | No | last viewed after this ISO date or relative like '-30d' | |
| lastViewedBefore | No | last viewed before this ISO date or relative like '-3y'. Never-watched items match too unless watched='watched' |