plex-media-playback

Play, control, and recommend media on Plex players through the plex MCP server.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/moistalgia/hermes-tools --skill plex-media-playback-moistalgia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plex-media-playback
Source: https://github.com/moistalgia/hermes-tools/tree/main/skills-from-hermes/media/plex-media-playback
Command: npx skills add https://github.com/moistalgia/hermes-tools --skill plex-media-playback-moistalgia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It lets you play movies and TV shows on household Plex players, control active playback, and get recommendations from the existing library without touching the Plex API, Home Assistant, or hand-written scripts directly. ## Core Features & Use Cases - Playback and control: Play titles by name, play the next episode of a show, pause, resume, stop, seek, adjust volume, and switch subtitle or audio tracks across Roku, Fire TV, and desktop players. - Library-grounded recommendations: Use genre vocabulary from library_overview with discover and similar_to to suggest only titles that actually exist on the server, including "something like Inception" requests. - Playlists and library fixes: Build and play playlists for movie nights, repair watched flags with mark_watched, refresh mismatched metadata, and rescan libraries after new downloads. - Use Case: Someone says "put a fantasy epic on in the theater." The skill checks player readiness, queries the library's genre vocabulary, finds a matching unwatched title, plays it on the theater Roku, and confirms playback actually started. ## Quick Start Ask the assistant to play a specific movie or show on a named room's TV, such as "play The Matrix in the theater," and it will resolve the player, start playback, and confirm the session began.

Frequently Asked Questions about plex-media-playback

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I play a movie on a specific TV with Plex?▼

Call the plex MCP `play` tool with the title and player name. It searches the library, picks the best match, wakes Roku devices whose Plex app is closed, starts playback, and confirms a session began. Check `confirmed_playing` in the response before reporting success.

How do I get movie recommendations from my Plex library?▼

Call `library_overview` first to get the exact genre vocabulary, then use `discover` with matching genres, which are ANDed by default. For "something like X" requests, use `similar_to`, which ranks by shared genres. Only recommend titles returned by these tools.

Why can't I pause or seek on my Fire TV with Plex?▼

The Fire TV never advertises itself as a player, so it has no Companion control channel and rejects pause, seek, and volume commands permanently. The only command that works is `stop`, which is a server-side session termination that never touches the device.

Can I use Home Assistant to control Plex playback instead?▼

No. Home Assistant's Plex integration hits the same device limitations and adds indirection; it was tested against this hardware and refused commands. All playback work must go through the plex MCP server's `mcp__plex__*` tools.

What should I do when Plex playback tools fail or are missing?▼

Run `plex_status` first to separate server-unreachable from token or argument errors. If the tools don't resolve at all, the MCP server isn't loaded from the Hermes config, which requires a host-side fix and restart, not an alternate transport.

Why does playing from the beginning restart at an old position?▼

When a title has an existing Plex resume point, `offset_seconds=0` can silently keep the old position. Instead of retrying `play`, call `seek` with the target seconds afterward, which reliably corrects the playback position.