4,500+ servers built on MCP Fusion
Vinkius

Plex MCP. Manage your whole library through conversation.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Plex MCP on Cursor AI Code Editor MCP Client Plex MCP on Claude Desktop App MCP Integration Plex MCP on OpenAI Agents SDK MCP Compatible Plex MCP on Visual Studio Code MCP Extension Client Plex MCP on GitHub Copilot AI Agent MCP Integration Plex MCP on Google Gemini AI MCP Integration Plex MCP on Lovable AI Development MCP Client Plex MCP on Mistral AI Agents MCP Compatible Plex MCP on Amazon AWS Bedrock MCP Support

Just plug in your AI agents and start using Vinkius.

Plex MCP Server manages your entire Plex Media Server library through natural conversation. It lets you browse movies, find specific episodes, check who's watching what right now, and manage metadata—all without opening a single tab or clicking through menus.

You can use it to search for content by name using `search_library`, review the full cast list with `get_metadata`, or even see which shows are next up with `get_on_deck`.

It's your AI client talking directly to your media archive.

What your AI agents can do

Get all episodes

Retrieves the complete list of episodes for a specific TV series.

Get children

Fetches related content, like all seasons for a show or all albums for an artist, given a parent item's key.

Get libraries

Lists every distinct media section (like 'Movies' or 'Music') configured on the server.

+ 12 more capabilities included
Check server health

You get basic status information about the Plex Media Server itself.

List all media sections

The agent lists every content library (e.g., Movies, Music) configured on your Plex account.

Find specific media

You search the entire library using keywords to find matching movies, shows, or artists.

Get detailed item specs

The system returns full data on any single piece of media, including cast, file info, and genres.

Monitor active viewing

You see a list of every user currently streaming content, noting their progress and device used.

Manage watch status

You can programmatically mark any item as watched or unwatched.

Supported MCP Clients

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients
Free for Subscribers

Waiting for input…

AI Agent

Plex MCP Server: 15 Tools for Media Management

These tools let you talk to all parts of your Plex library—from checking server health to marking individual items as watched.

get019d846e

get all episodes

Retrieves the complete list of episodes for a specific TV series.

get019d846e

get children

Fetches related content, like all seasons for a show or all albums for an artist, given a parent item's key.

get019d846e

get libraries

Lists every distinct media section (like 'Movies' or 'Music') configured on the server.

get019d846e

get library content

Pulls all content from a specific library by filtering it by type, requiring a key obtained from `get_libraries`.

get019d846e

get metadata

Provides full details—cast, director, file paths, summary—for any single media item.

get019d846e

get on deck

Identifies the next unwatched episode for every show currently being watched by users.

get019d846e

get playlist items

Returns a list of items, including titles and types, contained within a specified playlist ID.

get019d846e

get playlists

Gets a count and title for every user-created playlist on the server.

get019d846e

get recently added

Lists all movies, episodes, or albums that have been added to your library most recently.

get019d846e

get server info

Checks the general connectivity and status health of the Plex Media Server.

get019d846e

get sessions

Returns detailed information on every streaming session, including progress and device used.

mark019d846e

mark unwatched

Resets the watch status of a media item, signaling that it hasn't been seen yet.

mark019d846e

mark watched

Updates the item's record to show it has been viewed and removes it from 'On Deck'.

refresh019d846e

refresh library

Triggers a full scan of a specific library, necessary after adding or moving files.

search019d846e

search library

Searches the entire media collection for matching items by title, artist, or keywords.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with Plex, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 4,700+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week

What you can do with this MCP connector

You connect this MCP Server to manage every damn thing on your Plex Media Server using just plain talk. It takes the nightmare of clicking through menus and turns it into a simple chat session with your media archive. Your AI client talks directly to the server, making library navigation automatic.

To start, you can check the overall health and connection status of the entire Plex system using get_server_info. You'll also list every distinct content section—whether that's 'Movies,' 'TV Shows,' or 'Music'—by calling get_libraries, giving you a map of everything configured.

Need to find something specific? The system lets you search your entire media collection using keywords, titles, or artists with search_library. You can also see what content was recently added to the server by running get_recently_added and pulling up all movies, episodes, or albums that just showed up. Once you know which library you're dealing with, you pull all its contents—filtered by type—using get_library_content, making sure your agent knows exactly what it’s looking at.

When you zero in on a piece of media, you get deep data dives. You run get_metadata to grab full details for any single item; that means getting the cast list, the director, file paths, genres, and summaries all in one shot. If the content is a TV series, you can expand your search using get_children, which lets you jump from the main show title directly into its seasons or even related albums.

For episode-specific details, you've got get_all_episodes, which pulls the complete list for any given TV series.

To keep things organized, you manage playlists with two tools: first, get_playlists counts and names every user-made playlist on the server; second, if you want to see what’s inside one of those lists, get_playlist_items returns a full list of titles and types contained within a specified ID. If your library structure gets messy—like after moving or adding a bunch of files manually—you gotta run refresh_library on a specific section so the server actually sees it.

Tracking who’s watching what is straightforward. You pull detailed information on every single streaming session using get_sessions, knowing exactly which user, device, and amount of progress they've hit. If you want to know what episode is next for any show currently being watched by users, get_on_deck identifies that specific unwatched episode.

When the viewing status needs changing—maybe someone paused it or finished it early—you programmatically update records: run mark_watched to confirm an item was viewed and take it off 'On Deck,' or use mark_unwatched to reset its status, making it appear available again.

This whole process keeps your AI client talking only in function calls. It manages everything from listing content libraries using get_libraries, to checking if the server is even up with get_server_info. You’re not limited to just searching; you can get a full inventory of playlists, pull specific items, and maintain detailed records on every single piece of media in your archive.

How Plex MCP Works

  1. 1 Subscribe to the Plex MCP Server and enter your required Plex Token and Server URL.
  2. 2 Your AI client authenticates the connection, allowing it to send tool calls directly to your media server instance.
  3. 3 You receive structured data—like a list of active streams or metadata for a film—delivered right back into your chat window.

The bottom line is you talk to your AI agent, and the agent talks to Plex for you, so you never have to leave your messaging app.

Who Is Plex MCP For?

This is for anyone who uses a central media server but hates the web UI. Think of the tech-savvy home user who wants their AI client to be the main control panel, or the system admin who needs an API layer to monitor streaming health without logging into Plex.

Home Media User

Needs a fast way to discover content. Instead of clicking 'Movies' then searching titles, they just ask the agent: 'Show me all 80s sci-fi movies.' They rely on search_library and get_metadata.

Server Administrator

Needs to monitor server health. They use tools like get_server_info or get_sessions to check bandwidth usage, active connections, or if the library needs a refresh via refresh_library.

Family Manager

Needs to track family viewing habits. They use mark_watched and mark_unwatched to keep records accurate and check who's watching what using get_sessions.

What Changes When You Connect

  • Track viewing habits accurately. Use mark_watched or mark_unwatched to update item status instantly, keeping your personal records clean.
  • Instantly discover content. Instead of browsing folders, use search_library to find any movie, artist, or episode using just keywords.
  • Monitor activity in real time. The get_sessions tool shows exactly who is watching what right now, including their progress and device type.
  • Go beyond simple searching. Use get_metadata to pull all the deep details—director, cast list, file path—for any item you find.
  • Keep your collection current. If you drop new files into a folder, run refresh_library so the server indexes them immediately for viewing.

Real-World Use Cases

01

The Family Cleanup

A parent notices they don't know who watched the last season of 'Succession.' They ask their agent: 'Who has been watching my TV shows?' The agent runs get_sessions, listing every active stream, letting them see exactly which family member is on what device and at what progress point.

02

The Deep Dive Research

A user wants to know if a director worked on two different films. They use get_metadata on Film A, get the cast/director list. Then they repeat the process for Film B, comparing the results instantly without opening separate database tabs.

03

The New Content Audit

A server admin adds 500 new files to the 'Movies' folder. They don't want to wait for a manual scan; they ask the agent to run refresh_library and immediately follow up with get_recently_added to confirm everything is indexed.

04

The Next Episode Queue

A user opens their chat and asks, 'What should I watch next?' The agent runs get_on_deck, providing a curated list of the very next unwatched episode for all series they've been following.

The Tradeoffs

Assuming search is enough

A user asks, 'Show me that movie about space.' The agent runs search_library, which returns 20 titles. This doesn't tell the user if the director or cast matches their memory.

First, use search_library to narrow down the title. Then, immediately pass the resulting item ID into get_metadata. This gives you the full context—like the specific year and main cast members—so you can confirm it's the right movie.

Forgetting library changes

A user moves a folder of photos to a new spot. They then ask, 'Show me my Photos Library.' The agent tries to read old data because the server hasn't scanned the new location.

Before asking for content, you must run refresh_library using the specific library key first. This forces Plex to index the files in their new spot before you try to pull the list with get_library_content.

Mixing up lists

A user asks for 'my shows,' but then also wants the playlist contents. They confuse which tool pulls what, leading to data dumps that mix movie metadata with audio track names.

Always use get_libraries first to confirm the library type (movie vs. music). Then, if you need specific content from a list, always call get_playlist_items, making sure you provide the correct playlist ID.

When It Fits, When It Doesn't

Use this server if your primary goal is deep media management and status tracking. You need to know who watched what, or you need detailed technical specs (cast, file paths) beyond just the title. If you're mainly using Plex for simple browsing—just clicking through categories on the official website—you don't need this level of tool complexity. However, if your pain point is manually cross-referencing metadata from multiple tabs, or needing to programmatically update watch status across different platforms (e.g., marking it watched after an automated script runs), then this collection of 15 tools is exactly what you need.

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Plex. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 15 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

get_all_episodes get_children get_libraries get_library_content get_metadata get_on_deck get_playlist_items get_playlists get_recently_added get_server_info get_sessions mark_unwatched mark_watched refresh_library search_library

Figuring out who's watching what shouldn't be a manual dashboard drill-down.

Right now, checking on family viewing habits means logging into the Plex web interface. You click 'Activity,' then filter by user, then scroll through timestamps and playback progress reports. It takes five clicks just to see if someone hit pause or what movie they started last.

With this MCP server, you simply ask your agent: 'What's playing right now?' The agent runs `get_sessions` and instantly returns a clean list: User X is watching Movie Y at 34 minutes. It gives you the data you need in one shot.

Plex MCP Server: Get full media context from chat.

Before, if you found a movie title and needed to know who directed it, or what cast members were involved, you had to copy the title and paste it into Google, then click through Wikipedia. It was tedious guesswork.

Now, your agent runs `get_metadata` on that title. You get the full director list, cast, year, and file path delivered directly back to you—no jumping between tabs necessary.

Common Questions About Plex MCP

How do I get my Plex Token? +

Log in to your Plex account at 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.

How do I use `get_libraries` to find all media sections on my server? +

It returns a list of every library section (movies, shows, music) with its unique key and item count. You'll need this key when using other tools like filtering or scanning.

What detailed data does `get_metadata` provide for a specific media item? +

The tool provides rich details, including the cast, director, runtime, file path, and genres. This goes far beyond just title and summary.

If I add or delete files, how do I use `refresh_library` to update the server data? +

Running this tool forces a library scan on your specified key. It updates metadata immediately, ensuring that new or deleted content is visible to your AI agent.

How can I check and manage my curated collections using `get_playlists`? +

Use get_playlists first to gather all playlist IDs. Then, pass a specific ID to the tool to retrieve the titles and metadata of every item saved in that collection.

You might also like

Built & Managed by Vinkius 30s setup 15 tools

We've already built the connector for Plex. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 15 tools are live and waiting. You're up and running in seconds.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.