plex

Control Plex Media Server - browse libraries, search, play media, manage playback.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026

When & Why to Use This Skill

This Claude skill enables seamless integration with Plex Media Server, allowing users to programmatically browse libraries, search for content, and manage media playback through the Plex API. It streamlines home media management by providing instant access to server status, active sessions, and library metadata directly within the AI interface, making it an essential tool for home lab enthusiasts and media collectors.

Use Cases

  • Media Discovery: Quickly search for specific movies, TV shows, or music across multiple libraries using natural language queries instead of manual navigation.
  • Playback Control: Remotely trigger and manage media playback on authorized Plex clients and devices directly through the agent.
  • Server Monitoring: Real-time monitoring of active streaming sessions and server status to see what is currently being played and by whom.
  • Library Auditing: Retrieve detailed metadata, section keys, and 'Recently Added' lists to efficiently organize or audit large media collections.
  • Continue Watching: Instantly access 'On Deck' content to resume shows or movies from where you left off without opening the Plex UI.
nameplex
descriptionControl Plex Media Server - browse libraries, search, play media, manage playback.
homepagehttps://plex.tv
metadata{"clawdis":{"emoji":"🎬","requires":{"bins":["curl"],"env":["PLEX_TOKEN","PLEX_SERVER"]},"primaryEnv":"PLEX_TOKEN"}}

Plex Media Server

Control Plex Media Server using the Plex API.

Setup

Set environment variables:

  • PLEX_SERVER: Your Plex server URL (e.g., http://192.168.1.100:32400)
  • PLEX_TOKEN: Your Plex auth token (find it at plex.tv/claim or in Plex app XML)

Common Commands

Get Server Info

curl -s "$PLEX_SERVER/?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"

Browse Libraries

curl -s "$PLEX_SERVER/library/sections?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"

List Library Contents

# Replace 1 with your library section key (from browse above)
curl -s "$PLEX_SERVER/library/sections/1/all?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
curl -s "$PLEX_SERVER/search?query=SEARCH_TERM&X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"

Get Recently Added

curl -s "$PLEX_SERVER/library/recentlyAdded?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"

Get On Deck (Continue Watching)

curl -s "$PLEX_SERVER/library/onDeck?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"

Get Active Sessions (What's Playing Now)

curl -s "$PLEX_SERVER/status/sessions?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"

List Available Clients/Players

curl -s "$PLEX_SERVER/clients?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"

Library Section Types

  • Movies (usually section 1)
  • TV Shows (usually section 2)
  • Music
  • Photos

Notes

  • Add -H "Accept: application/json" for JSON output (default is XML)
  • Library section keys (1, 2, 3...) vary by server setup — list sections first
  • Media keys look like /library/metadata/12345
  • Always confirm before starting playback on a device
  • Get your token: plex.tv → Account → Authorized Devices → XML link