Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Plex with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Manage your Plex Media Server. browse libraries, search media, check active streams and control playback from any AI agent.

Included with plan

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.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 15 capabilities

The complete Plex capability set.

These are the exact actions your AI can choose when you ask it to work with Plex.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 15 available through Plex.

  1. 01

    Get all episodes

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

  2. 02

    Get children

    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)

  3. 03

    Get libraries

    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 capabilities. Get all libraries (sections) on the Plex server

  4. 04

    Get playlists

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

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 15 available through Plex.

  1. 05

    Get server info

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

  2. 06

    Mark unwatched

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

  3. 07

    Get metadata

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

  4. 08

    Get library content

    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

Capability set03 / 04

09-12

4 capabilities in this set.

Part of 15 available through Plex.

  1. 09

    Get on deck

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

  2. 10

    Get playlist items

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

  3. 11

    Get recently added

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

  4. 12

    Get sessions

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

Capability set04 / 04

13-15

3 capabilities in this set.

Part of 15 available through Plex.

  1. 13

    Mark watched

    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

  2. 14

    Refresh library

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

  3. 15

    Search library

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

Observed, not estimated

905ms average. Fast in production.

Plex is checked daily against the live service.

Daily averagePeak 1056ms
Aug 20Today
Fastest day
745ms
Slowest day
1056ms
14-day trend
Slowing+20%

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.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 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

FAQ

Questions Plex owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

  • 04

    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

More in Content Management

Suggestions