plex

Query Plex Media Server to browse libraries, search media, and monitor active sessions.

69|7|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/jmagar/claude-homelab --skill plex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plex
Source: https://github.com/jmagar/claude-homelab/tree/main/skills/plex
Command: npx skills add https://github.com/jmagar/claude-homelab --skill plex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Plex environments often require manual queries or web UI navigation to monitor libraries, search content, and track playback. This Skill consolidates those tasks into a consistent, read-only interface.

Core Features & Use Cases

  • Browse library sections and contents across Plex servers
  • Search for media across libraries
  • Check active playback sessions and “On Deck” items
  • Retrieve server identity and basic status for health checks
  • Real-world use: "What’s on Plex now?" or "Show me movies in the Movies library"

Quick Start

Run the Plex API helper to verify connectivity to your Plex server.

Frequently Asked Questions about plex

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

FAQPage Schema
How do I monitor active Plex Media Server playback sessions from the command line?

You can monitor active Plex Media Server playback sessions by executing read-only API requests to check what is currently playing. This Skill uses a plex-api.sh helper script to query active sessions and list available clients without requiring web UI navigation.

Do I need a Plex token to browse media libraries via API?

Yes, you need a Plex token to browse media libraries via API. The Skill requires PLEX_URL and PLEX_TOKEN environment variables to authenticate read-only requests, allowing you to view library sections, search content, and retrieve server identity.

What's the best way to search for movies across Plex libraries without using the web interface?

The best way to search for movies across Plex libraries without the web interface is using a read-only API helper script. This Skill queries your Plex Media Server to search media across libraries, check "On Deck" items, and retrieve basic server status.

Does monitoring Plex servers with curl require any special dependencies?

Monitoring Plex servers with curl requires the jq dependency to parse JSON API responses. The Skill uses curl to execute authenticated, read-only requests against your Plex Media Server, browsing library contents and tracking active sessions.

Can I control Plex Media Server playback or is this limited to read-only queries?

This Skill is limited to read-only queries and cannot control Plex Media Server playback. It focuses on monitoring tasks like browsing library sections, searching for media, checking active playback sessions, and viewing recently added content.

Why query the Plex API directly instead of navigating the web UI to check recently added content?

Querying the Plex API directly provides a consistent, scriptable interface to check recently added content without manual web UI navigation. It consolidates monitoring tasks into read-only requests, allowing quick retrieval of server identity, active sessions, and library contents.