Skip to content

Demonstrates how to add/remove items to/from a Plex Watchlist using the API

Notifications You must be signed in to change notification settings

dalepmay/Plex-Watchlist

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Plex Watchlist API (Unofficial)

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.


πŸš€ Features

  • βœ… 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

πŸ› οΈ Requirements

  • Node.js (18+)
  • A valid Plex account
  • Your Plex X-Plex-Token (can be found via browser dev tools or via Plex API tools)

πŸ“„ Usage

  1. Set your Plex token as an environment variable:
export PLEX_TOKEN=your-plex-token

About

Demonstrates how to add/remove items to/from a Plex Watchlist using the API

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published