# Plex

> Plex is an Agent Skill for apps & automation published in the sundial-org/awesome-openclaw-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

- Skill name: `plex`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/plex/SKILL.md
- Repository: sundial-org/awesome-openclaw-skills (629 GitHub stars when collected)

## SKILL.md

# 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
```bash
curl -s "$PLEX_SERVER/?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
```

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

### List Library Contents
```bash
# 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"
```

### Search
```bash
curl -s "$PLEX_SERVER/search?query=SEARCH_TERM&X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
```

### Get Recently Added
```bash
curl -s "$PLEX_SERVER/library/recentlyAdded?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
```

### Get On Deck (Continue Watching)
```bash
curl -s "$PLEX_SERVER/library/onDeck?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
```

### Get Active Sessions (What's Playing Now)
```bash
curl -s "$PLEX_SERVER/status/sessions?X-Plex-Token=$PLEX_TOKEN" -H "Accept: application/json"
```

### List Available Clients/Players
```bash
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

---

Source: https://www.openparable.com/skill/apps-automation/plex (OpenParable). Cite the canonical URL above.
