plex-query

Converts natural-language queries into CLI-based searches for movies and TV shows.

1|Updated Dec 17, 2025

Search Tags:#nlp #query #filters #cli-tools #plex #tv-shows #movies

Ready to run

npx skills add https://github.com/lepinkainen/skills --skill plex-query

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: plex-query
Source: https://github.com/lepinkainen/skills/tree/main/plex
Command: npx skills add https://github.com/lepinkainen/skills --skill plex-query

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires plexapi, and includes scripts (resource) components.

What problem does it solve?

This skill enables querying a Plex Media Server using natural language to locate movies and TV shows, helping you quickly discover what to watch.

Core Features & Use Cases

Flexible filtering: search by duration, genre, actors, year, ratings, and watch status for both movies and TV shows
Cross-type queries: handle queries about standalone movies or TV series, including ongoing progress and unwatched content
Guided automation: suggests exact CLI commands using plex-movie, plex-tv, and plex-genres to fetch results
Example scenario: "I have 90 minutes and want a high-rated romantic movie" returns suitable options with metadata

Quick Start

Ask Plex a question about your library and receive filtered results using the plex-movie, plex-tv, and plex-genres CLI tools.

Frequently Asked Questions about plex-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I search my Plex library using natural language filters?▼

You can search your Plex library using natural language by querying for movies and TV shows with filters like duration, genre, actors, year, and watch status. The skill translates queries into CLI commands to fetch results.

Can I find unwatched movies on my Plex server by duration and rating?▼

Yes, you can locate unwatched movies on Plex by filtering for specific durations and ratings. The skill processes natural language requests to return suitable options complete with metadata.

How do I query Plex for TV shows with ongoing watch progress?▼

To query Plex for TV shows with ongoing watch progress, use natural language to filter by watch status. The skill handles cross-type queries for both movies and television series.

Do I need plexapi installed to query Plex libraries with natural language?▼

Yes, you need the plexapi dependency installed to query your Plex libraries. The skill leverages plex-movie, plex-tv, and plex-genres CLI tools built on this library to output JSON-friendly results.

What is the best way to get AI-friendly JSON results from a Plex media server?▼

The best way to get AI-friendly JSON results from a Plex media server is using natural language queries that leverage CLI tools to fetch filtered movies and TV shows. The output is structured for AI reasoning.