Can I limit the number of results returned?

Yes, the tools have a default limit of 20 results, but this can be adjusted using the --limit parameter to prevent overwhelming the conversation with too much data.

Does this skill help me find shows I've already started watching?

Absolutely. You can use specific flags like --started or --in-progress to find TV shows that have at least one watched episode and remaining unwatched episodes.

What happens if I search for a genre that doesn't exist?

The skill includes a plex-genres tool that Claude can use to list all available genres in your library, allowing it to correct the search or suggest available alternatives.

How does this skill connect to my Plex server?

The skill uses the plexapi Python library and requires your Plex Server URL and an authentication token to be configured as environment variables (PLEX_URL and PLEX_TOKEN).

Can I filter results by specific actors or directors?

Yes, the plex-movie and plex-tv tools support parameters for partial matching of actor and director names across your entire library.

Plex Media Query

Name: Plex Media Query
Author: lepinkainen

bylepinkainen

Content Management

Queries and filters your Plex Media Server library using natural language to find movies and TV shows based on specific metadata and watch status.

About

The Plex Media Query skill empowers users to interact with their Plex library through conversational commands, making it easy to discover content based on nuanced preferences. By leveraging Python-based CLI tools that interface with the Plex API, this skill can filter media by duration, genre, ratings, cast, and watch history. It is particularly useful for finding 'unwatched' content, identifying shows currently in progress, or matching media to specific time constraints, such as finding a high-rated movie under 100 minutes for a quick viewing session.

Key Features

0 GitHub stars
Watch status tracking to identify unwatched content or shows in progress
Episode-level insights including unwatched counts and progress percentages
Genre discovery tool to ensure accurate matching against library metadata
Advanced filtering for movies and TV shows by actor, director, genre, and rating
Time-constrained queries to find media matching specific duration limits

Use Cases

Discovering unwatched content from specific actors or directors within a certain decade
Finding a high-rated romantic movie under 100 minutes to watch
Checking how many unwatched episodes remain for a specific TV series like 'Always Sunny'

About

Key Features

0 GitHub stars
Watch status tracking to identify unwatched content or shows in progress
Episode-level insights including unwatched counts and progress percentages
Genre discovery tool to ensure accurate matching against library metadata
Advanced filtering for movies and TV shows by actor, director, genre, and rating
Time-constrained queries to find media matching specific duration limits

Use Cases

Discovering unwatched content from specific actors or directors within a certain decade
Finding a high-rated romantic movie under 100 minutes to watch
Checking how many unwatched episodes remain for a specific TV series like 'Always Sunny'