Help us improve
Share bugs, ideas, or general feedback.
From overseerr-mcp
Control Plex Media Server - browse libraries, search media, check what's playing, view recently added. Use when the user asks to "check Plex", "search Plex", "what's on Plex", "recently added", "what did I add to Plex recently", "continue watching", "on deck", "what was I watching", "who's watching", "Plex sessions", "Plex library", "browse movies", "browse TV shows", "is Plex working", "my Plex collection", "refresh library", "scan Plex for new media", "Plex playlists", or mentions Plex media server.
npx claudepluginhub jmagar/claude-homelab --plugin overseerr-mcpHow this skill is triggered — by the user, by Claude, or both
Slash command
/overseerr-mcp:plexThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Control and query Plex Media Server using the Plex API. Browse libraries, search media, and monitor active sessions.
Queries Plex Media Server API to browse libraries (movies, TV), search media, check active sessions, view recently added and on-deck content. Invoke on Plex mentions.
Searches Pirate Bay torrents via apibay.org API, extracts magnet links using CLI (season, smart, grab) or direct calls. For torrent searches, seeders, top lists.
Mandates invoking relevant skills via tools before any response in coding sessions. Covers access, priorities, and adaptations for Claude Code, Copilot CLI, Gemini CLI.
Share bugs, ideas, or general feedback.
Control and query Plex Media Server using the Plex API. Browse libraries, search media, and monitor active sessions.
This skill provides primarily read access to your Plex Media Server:
Add credentials to ~/.config/overseerr-mcp/.env (or ~/.config/overseerr-mcp/.env). Run the config-media-stack skill to configure automatically.
# Plex Media Server
PLEX_URL="http://192.168.1.100:32400"
PLEX_TOKEN="<your_plex_token>"
PLEX_URL: Your Plex server URL with port (default: 32400)PLEX_TOKEN: Your Plex authentication tokenGetting your Plex token:
X-Plex-Token in the URLAll commands output JSON. Use jq for formatting or filtering.
The plex-api helper script simplifies API access. Located at: skills/plex/scripts/plex-api
# Using helper script
bash skills/plex/scripts/plex-api info
# Or raw curl
curl -s "$PLEX_URL/?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
List all library sections:
# Using helper script
bash skills/plex/scripts/plex-api libraries
# Or raw curl
curl -s "$PLEX_URL/library/sections?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
# Using helper script (replace 1 with your section key)
bash skills/plex/scripts/plex-api library 1
bash skills/plex/scripts/plex-api library 1 --limit 50 --offset 100
# Or raw curl
curl -s "$PLEX_URL/library/sections/1/all?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
# Using helper script
bash skills/plex/scripts/plex-api search "Inception"
bash skills/plex/scripts/plex-api search "Avengers" --limit 10
# Or raw curl
curl -s "$PLEX_URL/search?query=SEARCH_TERM&X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
# Using helper script (default: 20 items)
bash skills/plex/scripts/plex-api recent
bash skills/plex/scripts/plex-api recent --limit 10
# Or raw curl
curl -s "$PLEX_URL/library/recentlyAdded?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
# Using helper script (default: 10 items)
bash skills/plex/scripts/plex-api ondeck
bash skills/plex/scripts/plex-api ondeck --limit 5
# Or raw curl
curl -s "$PLEX_URL/library/onDeck?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
# Using helper script
bash skills/plex/scripts/plex-api sessions
# Or raw curl
curl -s "$PLEX_URL/status/sessions?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
# Using helper script
bash skills/plex/scripts/plex-api clients
# Or raw curl
curl -s "$PLEX_URL/clients?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
# Server identity
bash skills/plex/scripts/plex-api identity
# Get metadata for specific item (by rating key)
bash skills/plex/scripts/plex-api metadata 12345
# Get children of item (e.g., seasons of a TV show)
bash skills/plex/scripts/plex-api children 12345
# List playlists
bash skills/plex/scripts/plex-api playlists
# Refresh library section (scan for new media)
bash skills/plex/scripts/plex-api refresh 1
# View all commands
bash skills/plex/scripts/plex-api --help
When the user asks about Plex:
Common section types (keys vary by server):
Always list sections first to get the correct section keys for your server.
-H "Accept: application/json" for JSON output/library/metadata/12345jq to filter and format JSON responsesrefresh triggers a library scan (write side-effect) — safe but not instantaneousaccounts (list Plex accounts), prefs (server preferences)To query multiple Plex servers:
# Server 1
PLEX_URL="http://server1:32400" PLEX_TOKEN="token1" curl ...
# Server 2
PLEX_URL="http://server2:32400" PLEX_TOKEN="token2" curl ...
For detailed local reference, see:
When running script commands via the zsh tool, always pass pty: true — without it, command output will be suppressed even though the command executes successfully.