Plex Connector for AI agents.
15 live capabilities
Manage your home media library and active streams through natural conversation.
Waiting for input…
Why people use Plex
Plex Media Management for Home Entertainment
With this Connector, you can just talk to your AI to get things done. Instead of clicking through five different screens, you ask your agent to show you what is on deck or to find a specific movie from the 90s. You get your answer in seconds, turning your media library into a conversational assistant.
What Vinkius changes
You get a voice-like interface for your entire home media library.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
Checking for bandwidth
A user wants to know if the kids are streaming 4K video.
- Real-world use case 02
Planning a movie night
Someone can't remember a movie title.
- Real-world use case 03
Updating watch status
A user finishes a show and tells the agent to mark_watched so it disappears from the On Deck list.
Complete set · 15capabilities
The complete Plex capability set.
These are the exact actions your AI can choose when you ask it to work with Plex.
01—04
4 capabilities in this set.
Part of 15 available through Plex.
- 01 Capability
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.
- 02 Capability
Get children
Retrieve seasons for shows or albums for artists based on the parent item. This helps you navigate deeper into a series.
- 03 Capability
Get libraries
List all media sections like movies, shows, or photos on your Plex. Use these keys to filter your content.
- 04 Capability
Get library content
Fetch all items from a specific library filtered by type. This lets you see everything in a specific section.
05—08
4 capabilities in this set.
Part of 15 available through Plex.
- 05 Capability
Get on deck
See the next unwatched episode for all shows you are currently following. This shows what is coming up next.
- 06 Capability
Get playlist items
List all titles and metadata for items in a specific playlist. This shows everything inside your custom lists.
- 07 Capability
Get playlists
Browse all existing playlists on your Plex. This shows your custom curated collections.
- 08 Capability
Get recently added
See the newest movies, episodes, and albums added to your library. This highlights your latest additions.
09—12
4 capabilities in this set.
Part of 15 available through Plex.
- 09 Capability
Get server info
Check your Plex status, version, and connected clients. This verifies your connection and health.
- 10 Capability
Mark unwatched
Reset a media item's watch status to unwatched. This clears your progress on a specific title.
- 11 Capability
Mark watched
Update an item's status to watched and remove it from your On Deck list. This tracks your progress accurately.
- 12 Capability
Refresh library
Trigger a manual scan of your media folders to update the library. This ensures your new files show up.
13—15
3 capabilities in this set.
Part of 15 available through Plex.
- 13 Capability
Get metadata
Pull details like cast, summary, year, and runtime for any media item. This gives you deep info on any title.
- 14 Capability
Get sessions
View active streams including user, progress, device, and transcoding info. This shows who is currently watching.
- 15 Capability
Search library
Search for movies, shows, episodes, artists, or albums by name. This finds specific content in your collection.
Set up in minutes
One URL. Then ask Plex to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Plex from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_kJQlXnaGqN0AOXVCBPu0NpLnnuwx46IvYg8ylWPK/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Plex, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Plex for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_kJQlXnaGqN0AOXVCBPu0NpLnnuwx46IvYg8ylWPK/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Plex URL.
- Step 03
Save and start
Save the connection and enable Plex in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"plex": {
"url": "https://edge.vinkius.com/vk_preview_kJQlXnaGqN0AOXVCBPu0NpLnnuwx46IvYg8ylWPK/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Plex
Open Agent mode in chat and ask: "Using Plex, help me...". 15 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"plex": {
"url": "https://edge.vinkius.com/vk_preview_kJQlXnaGqN0AOXVCBPu0NpLnnuwx46IvYg8ylWPK/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Plex
Ask Copilot: "Using Plex, help me...". 15 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"plex": {
"url": "https://edge.vinkius.com/vk_preview_kJQlXnaGqN0AOXVCBPu0NpLnnuwx46IvYg8ylWPK/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Plex
Open Cascade and ask: "Using Plex, help me...". 15 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"plex": {
"url": "https://edge.vinkius.com/vk_preview_kJQlXnaGqN0AOXVCBPu0NpLnnuwx46IvYg8ylWPK/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Plex
Ask Cline: "Using Plex, help me...". 15 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add plex --transport http "https://edge.vinkius.com/vk_preview_kJQlXnaGqN0AOXVCBPu0NpLnnuwx46IvYg8ylWPK/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Plex
Ask Claude: "Using Plex, show me...". 15 tools are ready
Where the request belongs
Work Plex can move forward.
This is for the home theater owner who hosts a large library and finds standard remote navigation tedious. It's for anyone who wants to manage their media without clicking through dozens of sub-menus.
Home Media Enthusiast
Checks what is playing on the big screen while sitting on the couch without reaching for a remote.
Home Server Admin
Monitors active sessions and Plex health without opening a web dashboard.
Family Manager
Checks what family members are watching and manages shared playlists for the kids.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsJellyfin (Plex Alternative)
Manage your media library via Jellyfin. list movies, shows, and music, track playback progress, and inspect server status directly from any AI agent.
Radarr (Movies)
Manage your movie library, search for new titles, and monitor download queues via Radarr.
Sonarr (TV)
Automate TV library management via Sonarr. list series, track episodes, and monitor download queues directly from any AI agent.
Brightcove
Manage your video library via Brightcove Video Cloud. list videos, manage playlists, and monitor performance directly from any AI agent.
Uscreen
Launch your own video streaming service with membership management, mobile apps, and monetization capabilities for content creators.
Cincopa
Manage video and media galleries via Cincopa. track assets, trigger uploads, and monitor engagement directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep Plex connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Plex.
The practical details behind the request, access and result.
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, 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.
One connection away
Give your agent a direct line to Plex.
Connect Plex once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available