Integrate Plex with Claude, Cursor, Chatbots & AI Agents MCP Server

Manage your Plex Media Server — browse libraries, search media, check active streams and control playback from any AI agent.

GDPR Free for Subscribers

Compatible with every major AI agent and IDE

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

+ other MCP clients

get

Get all episodes on Plex

Useful for getting the complete episode list for a series. Get all episodes of a TV show

get

Get children on Plex

For TV shows this returns seasons. For artists this returns albums. Requires the parent item's rating key. Get children of a media item (seasons or albums)

get

Get libraries on Plex

Each library includes its key (ID), type (movie, show, music, photo), title, agent, scanner and updated/created timestamps. Use the library key with other library tools. Get all libraries (sections) on the Plex server

get

Get library content on Plex

Filter by type: type=1 for movies, type=2 for TV shows, type=8 for artists, type=13 for photos. Requires the library key from get_libraries. Get all content from a specific library

get

Get metadata on Plex

Returns title, summary, year, runtime, rating, genres, director, cast, media streams, file path and more. Get detailed metadata for a specific item

get

Get on deck on Plex

Returns the next unwatched episode for each in-progress show. Get "On Deck" items (continue watching)

get

Get playlist items on Plex

Returns the items with their titles, types, durations and metadata. Requires the playlist ID. Get items in a specific playlist

get

Get playlists on Plex

Each playlist includes its ID, title, type (video, audio, photo), item count and duration. Get all playlists on the Plex server

get

Get recently added on Plex

Returns movies, episodes and albums with their titles, addition dates and metadata. Get recently added media to the library

get

Get server info on Plex

Useful for verifying server connectivity and checking server health. Get Plex Media Server information

get

Get sessions on Plex

Each session includes the user, the media being watched (movie/episode), playback progress, player device, bandwidth and transcoding info. Get currently active streaming sessions

mark

Mark unwatched on Plex

This resets the item's watch status. Requires the item's rating key. Mark a media item as unwatched

mark

Mark watched on Plex

This affects the item's watch status and removes it from "On Deck". Requires the item's rating key. Mark a media item as watched

refresh

Refresh library on Plex

Useful after adding or removing files from your media folders. Requires the library key. Trigger a library scan/refresh

Search library on Plex

Returns matching movies, shows, episodes, artists and albums with their titles, types and metadata. Search the Plex media library

Security & Code Integrity Audit

Every tool in the Plex MCP Server is continuously audited by the Vinkius Security Engine. We guarantee zero-trust payload isolation, strict data boundaries, and deterministic execution for enterprise-grade AI agents.

A+Score: 100

How Vinkius protects your data

Is there a risk of the AI "going crazy" and deleting important company data?

No. With Vinkius, the AI operates on "rails". It can only make the exact moves you authorized in the tool's settings. It cannot invent routes, access other networks in your company, or decide to delete random files. If the action isn't in the approved catalog, the attempt is blocked instantly.

Can I set different limits for each virtual assistant on my team?

Absolutely. You have full control in our command center. You can create an AI agent that only "reads" data so the support team can answer questions, and another superpowered agent that can "edit" and "create" information exclusively for your operations team. Each AI gets exactly the level of access you allow.

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.

How does the AI access my passwords and credentials?

It simply doesn't. On Vinkius, your passwords, API keys, and login details are kept in a secure vault. The AI (like ChatGPT or Claude) merely "asks" Vinkius to perform the task. Vinkius opens the door, does the work, and hands the result back to the AI. Your credentials are never seen, read, or learned by the artificial intelligence.

Triggering Plex via Natural Language

This integration supports direct MCP execution, enabling your chatbots to query and modify data within these specific environments.

Streamlining media server

Integrate Plex to access native media server capabilities. This allows LLMs to perform secure, deterministic execution of content management tasks without hard-coded API scripts.

Connecting streaming with Cursor

Integrate Plex for AI-driven streaming management. The MCP server structures the outputs required for Claude to analyze content management data.