# Plex MCP for AI Agents AI Agent Connect > Plex MCP lets you manage your Plex media library through natural conversation. Browse movies, check who is currently streaming, and manage your playlists directly from your AI agent. ## Overview - **Category:** content-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_kJQlXnaGqN0AOXVCBPu0NpLnnuwx46IvYg8ylWPK/ai-agent-connect - **Tags:** media-server, streaming, library-management, playback-control, media-metadata, self-hosted ## Description Plex lets you manage your entire media library through natural conversation. You can ask your agent to find that one 90s action movie you can't remember the name of or see if anyone is currently hogging the bandwidth on your home setup. Instead of digging through menus, you just talk to your AI. It can pull up the full cast and crew for a show, tell you what's next on your to watch list, and even refresh your library when you drop new files into your folders. This is one of the best ways to interact with your media collection because it turns a complex dashboard into a simple conversation. When you add this to the Vinkius catalog, your home media setup becomes an interactive assistant rather than just a remote control. You no longer have to navigate through layers of sub-menus just to find a specific album or check if a friend is currently watching a movie. It handles the heavy lifting of searching and filtering, giving you direct access to your content. Whether you are looking for a specific runtime, a certain genre, or just want to see what's new, the interaction stays fast and focused on your intent. It makes the jump from manual browsing to active discovery, letting you spend less time searching and more time actually watching. ## Tools ### get_all_episodes Get a complete list of every episode for a specific TV series. This provides a full overview of the show's contents. ### get_children Retrieve seasons for shows or albums for artists based on the parent item. This helps you navigate deeper into a series. ### get_libraries List all media sections like movies, shows, or photos on your Plex. Use these keys to filter your content. ### get_library_content Fetch all items from a specific library filtered by type. This lets you see everything in a specific section. ### get_on_deck See the next unwatched episode for all shows you are currently following. This shows what is coming up next. ### get_playlist_items List all titles and metadata for items in a specific playlist. This shows everything inside your custom lists. ### get_playlists Browse all existing playlists on your Plex. This shows your custom curated collections. ### get_recently_added See the newest movies, episodes, and albums added to your library. This highlights your latest additions. ### get_server_info Check your Plex status, version, and connected clients. This verifies your connection and health. ### mark_unwatched Reset a media item's watch status to unwatched. This clears your progress on a specific title. ### mark_watched Update an item's status to watched and remove it from your On Deck list. This tracks your progress accurately. ### refresh_library Trigger a manual scan of your media folders to update the library. This ensures your new files show up. ### get_metadata Pull details like cast, summary, year, and runtime for any media item. This gives you deep info on any title. ### get_sessions View active streams including user, progress, device, and transcoding info. This shows who is currently watching. ### search_library Search for movies, shows, episodes, artists, or albums by name. This finds specific content in your collection. ## Prompt Examples **Prompt:** ``` Show me what's currently playing on my Plex. ``` **Response:** ``` ### Active Streaming Sessions | User | Media Title | Progress | Device | Info | | :--- | :--- | :--- | :--- | :--- | | **John** | *The Last of Us* S01E03 | 34:15 / 58:22 | Roku | Direct Play | | **Sarah** | *Oppenheimer* | 1:45:30 / 3:00:15 | iPhone | Transcoding 1080p | ``` **Prompt:** ``` What's on deck for me to watch? ``` **Response:** ``` ### Continue Watching Here are the next unwatched episodes for your current shows: * **The Mandalorian** S03E05 * **Stranger Things** S04E07 * **Ted Lasso** S02E03 * **The Office** S07E19 * **Severance** S01E04 ``` **Prompt:** ``` Find some 90s action movies in my library. ``` **Response:** ``` ### Search Results: 90s Action I found a few matches in your library: * **Die Hard** (1988) - *Action, Thriller* * **Speed** (1994) - *Action, Adventure* * **Terminator 2: Judgment Day** (1991) - *Sci-Fi, Action* Would you like to see the full cast and summary for any of these? ``` ## Capabilities ### Browse your media library See all your movies, shows, music, and photos in one place. ### Check active streams See who is watching what right now including their playback progress. ### Find specific titles Search for any movie, episode, artist, or album by name. ### Get deep media details Retrieve full cast, summary, runtime, and file info for any item. ### Manage your playlists Browse and manage your custom playlists through your agent. ### Update watch status Mark items as watched or unwatched to keep your progress current. ## Use Cases ### Checking for bandwidth A user wants to know if the kids are streaming 4K video. They ask the agent to check get_sessions and see the device and transcoding info. ### Planning a movie night Someone can't remember a movie title. They ask the agent to search_library for 90s action and get a list of matches with metadata. ### Updating watch status A user finishes a show and tells the agent to mark_watched so it disappears from the On Deck list. ### Library maintenance An admin adds new files and tells the agent to refresh_library to make sure the new content shows up immediately. ## Benefits - Stop hunting through menus by using search_library to find any movie or album instantly. - Keep track of your progress with get_on_deck to see exactly what is next for every show you are watching. - Monitor your network usage by checking get_sessions to see who is streaming and what they are watching. - Keep your library organized by using mark_watched to update your progress without touching a remote. - Get instant details on any title using get_metadata to see cast, ratings, and runtimes in one go. - Stay on top of new content by quickly checking get_recently_added to see what hit your folders last. ## How It Works The bottom line is you get a voice-like interface for your entire home media library. 1. Subscribe to the Plex MCP within the Vinkius catalog. 2. Provide your Plex Token and Plex URL in the connection settings. 3. Ask your AI client to find content, check sessions, or update your watch status. ## Frequently Asked Questions **Can I use the Plex MCP to see who is currently watching my movies?** Yes, you can check active sessions to see which users are streaming, what they are watching, their current progress, and the device they are using. **Does the Plex MCP work with my own home server?** Yes, it connects to any Plex media setup using your unique token and Plex URL. **Can I mark shows as watched using the Plex MCP?** Yes, you can update your watch status directly through your agent, which will also remove those items from your continue watching list. **How do I find new movies on my Plex server with this Connector?** You can ask your agent to show you recently added content or search for specific genres and keywords to discover new additions. **Can the Plex MCP help me manage my playlists?** Yes, you can browse your existing playlists and see the specific items included in them through your AI client. **Will the Plex MCP help me with server health?** You can use it to check your Plex status, current version, and see which clients are currently connected to your setup. **How do I get my Plex Token?** Log in to your Plex account at [**plex.tv**](https://plex.tv), go to **Settings > Server > General** and look for 'X-Plex-Token'. Alternatively, check your browser's network tab when loading the Plex web app. **What is my Server URL?** For local access: `http://YOUR_SERVER_IP:32400` (e.g. `http://192.168.1.100:32400`). For remote access: `https://YOUR_PLEX_SUBDOMAIN.plex.direct:32400`. The IP is your Plex server's local network address. **Can I see what's currently playing?** Yes! Use get_sessions to see all active playback sessions. Each session shows the user, media title, playback position, player device and whether it's direct playing or transcoding. **Can I search for specific media?** Yes! Use search_library with any title. Results include movies, TV shows, episodes, artists and albums matching your query. Optionally filter by library key to search in a specific library only.