Watch history
watch_historyQuery watch and listen history across all Plex users, filtering by user, library, date range, or specific item to answer whether someone has seen or played something.
Instructions
Watch/listen history across ALL users: who played what, when. Filter by user (name or account id), library, time window (since/until, ISO dates), or a specific item (ratingKey: answers 'has X seen Y?'). Sorted newest first. kind filters the returned page client-side (movie/episode/track). total reflects the unfiltered count.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "watch_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | ||
| user | No | ||
| limit | No | ||
| since | No | ||
| until | No | ||
| offset | No | ||
| library | No | ||
| ratingKey | No | limit history to one item |