How do I connect my Plex server to this MCP?

You need to provide your Plex Token and your specific Server URL during the setup process on Vinkius.

Which AI clients can I use with this?

This MCP works with any compatible client, including Claude, Cursor, and Windsurf.

Can I see who is watching movies right now?

Yes, you can ask your agent to show active sessions to see users, devices, and playback progress.

Can I update my watch history through the chat?

Yes, you can tell your agent to mark specific items as watched or unwatched.

Does this work with music libraries?

Yes, the MCP can browse music libraries, find artists, and access albums.

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.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Plex to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Control your entire media library through your AI agent.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 15 capabilities

We ship only the actions that matter.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 15 available through Plex.

01
Get all episodes
This capability retrieves the full list of episodes for a specific TV series.
02
Get children
This capability fetches sub-items like seasons for a TV show or albums for a music artist.
03
Get libraries
This capability lists all media sections on your Plex setup, including movies, shows, and music.
04
Get playlists
This capability pulls a list of all your existing playlists.

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 15 available through Plex.

05
Get server info
This capability checks your connection and retrieves basic status information for the Plex setup.
06
Mark unwatched
This capability resets the watch status of a specific media item.
07
Get metadata
This capability provides detailed info like cast, summary, runtime, and file paths for a media item.
08
Get library content
This capability pulls all items from a specific library, filtered by type like movies or photos.

Capability set03 / 04

09-12

4 capabilities in this set.

Part of 15 available through Plex.

09
Get on deck
This capability identifies the next unwatched episodes for shows you are currently watching.
10
Get playlist items
This capability lists the specific media items contained within a chosen playlist.
11
Get recently added
This capability finds the newest movies, episodes, or albums added to your library.
12
Get sessions
This capability shows active streams, including which user is watching and their current playback progress.

Capability set04 / 04

13-15

3 capabilities in this set.

Part of 15 available through Plex.

13
Mark watched
This capability sets an item as watched and removes it from your On Deck list.
14
Refresh library
This capability triggers a fresh scan of your media folders to find new files.
15
Search library
This capability searches through your movies, shows, and music for specific titles or artists.

Real work

What teams actually run

Quick Content Lookup

Ask your agent to find a specific movie or artist within your massive collection.

Activity Monitoring

Check which devices are currently streaming and if they are transcoding.

Library Maintenance

Tell your agent to refresh your library after you move new files into your media folders.

Watchlist Management

Use the On Deck feature to quickly see which episode you need to watch next.

Automate a task

Put Plex to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Plex works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put Plex to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

948ms average. Fast in production.

Plex is checked daily against the live service.

Daily averagePeak 1159ms

Oct 3Today

Fastest day: 779ms
Slowest day: 1159ms
14-day trend: Stable-3%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 15 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Plex, so you can see the experience inside your AI.

It does not authenticate your account with Plex. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Plex Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_kJQlXnaGqN0AOXVCBPu0NpLnnuwx46IvYg8ylWPK/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Plex capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "plex-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_kJQlXnaGqN0AOXVCBPu0NpLnnuwx46IvYg8ylWPK/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Plex in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Plex owners hand off.

This MCP is built for anyone running a self-hosted media collection who wants a faster way to interact with their data.

01
Home Media Users
People who want to search their own libraries and find what to watch next using natural language.
02
Server Admins
Users who need to monitor active sessions and check the health of their Plex setup.
03
Family Managers
People who want to see what family members are watching and manage shared playlists.

FAQ

Questions Plex owners ask.

01
How do I connect my Plex server to this MCP?
You need to provide your Plex Token and your specific Server URL during the setup process on Vinkius.
02
Which AI clients can I use with this?
This MCP works with any compatible client, including Claude, Cursor, and Windsurf.
03
Can I see who is watching movies right now?
Yes, you can ask your agent to show active sessions to see users, devices, and playback progress.
04
Can I update my watch history through the chat?
Yes, you can tell your agent to mark specific items as watched or unwatched.
05
Does this work with music libraries?
Yes, the MCP can browse music libraries, find artists, and access albums.
06
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.
07
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.
08
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.
09
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.

Explore

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get all episodes

Get children

Get libraries

Get playlists

05-08

Get server info

Mark unwatched

Get metadata

Get library content

09-12

Get on deck

Get playlist items

Get recently added

Get sessions

13-15

Mark watched

Refresh library

Search library

What teams actually run

Quick Content Lookup

Activity Monitoring

Library Maintenance

Watchlist Management

Building your own app? The connector is yours to use.

Plex Connector

Claude Desktop

Home Media Users

Server Admins

Family Managers

How do I connect my Plex server to this MCP?

Which AI clients can I use with this?

Can I see who is watching movies right now?

Can I update my watch history through the chat?

Does this work with music libraries?

How do I get my Plex Token?

What is my Server URL?

Can I see what's currently playing?

Can I search for specific media?

Cockpit (Self-hosted Headless CMS API) AI Connector

Jellyfin (Plex Alternative) AI Connector

PhotoPrism AI Connector

Immich (Google Photos Alternative) AI Connector

Suggestions

Later (Social Media Management) AI Connector

ZEGO / 即构科技 AI Connector

Spotify Music AI Connector

Cincopa AI Connector