This project demonstrates how to programmatically add or remove items from a Plex user's Watchlist using an undocumented Plex cloud API.
Discovered via browser network inspection (XHR requests from Plex Web), this technique uses Plex's discover provider service β not your local Plex Media Server β to manage cloud-based Watchlist entries.
β οΈ This uses an undocumented API. It works at time of writing (2025), but may break without notice.
- β Add any Plex-supported movie or show to your Watchlist
- β Remove items from your Watchlist
- π¦ Works with your Plex account token β no local server access required
- Node.js (18+)
- A valid Plex account
- Your Plex X-Plex-Token (can be found via browser dev tools or via Plex API tools)
- Set your Plex token as an environment variable:
export PLEX_TOKEN=your-plex-token