How do I connect my Jellyfin server?

You need your Jellyfin Server URL and an API Key. Once you enter these into the Vinkius setup, the MCP is ready to use.

Which AI clients can I use with this MCP?

You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.

Can I manage users with this capability?

Yes, the MCP includes capabilities to list users and authenticate via name and password.

Does this work with Plex?

No, this specific MCP is designed for Jellyfin media servers.

Vinkius hosts the MCP and manages your credentials securely so you can connect your client once and stay connected.

Can I filter my library to only show Movies or Series?

Yes! Use the list_items capability and provide 'Movie' or 'Series' in the include_item_types parameter to filter your results accordingly.

How do I check if my Jellyfin server is running the latest version?

You can use the get_system_info capability. It returns the server version, operating system, and other vital system metrics.

Can I see all the root libraries configured on my server?

Absolutely. Run the list_virtual_folders capability to retrieve a list of all top-level libraries like Movies, TV Shows, and Music.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Jellyfin Plex (Alternative) to ChatGPT and Claude

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 self-hosted 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 · 12 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 12 available through Jellyfin.

01
List users
Access the full list of users on your Jellyfin instance. This capability is restricted to admin accounts.
02
Authenticate by name
Log in to the Jellyfin instance by providing a username and password.
03
Get item
Fetch specific metadata and details for a single media item.
04
Get current user
Retrieve profile information for the user currently logged into the session.

Capability set02 / 03

05-08

4 capabilities in this set.

Part of 12 available through Jellyfin.

05
Get playback info
Pull the technical data required to begin playing a specific piece of media.
06
Get system info
Check the Jellyfin version, operating system, and basic hardware details.
07
Session playing progress
Send updates to the Jellyfin instance regarding the current playback position.
08
List items
Search and browse through the various items within your media library.

Capability set03 / 03

09-12

4 capabilities in this set.

Part of 12 available through Jellyfin.

09
List virtual folders
View the top-level library folders like Movies or TV Shows.
10
Get system configuration
Retrieve the global configuration settings from the Jellyfin server.
11
Session playing
Tell the Jellyfin instance that a media session has started.
12
Session playing stopped
Notify the Jellyfin instance that playback has finished or been interrupted.

Real work

What teams actually run

Quick Library Searches

Ask your agent to find a specific movie title without scrolling through endless lists.

Server Health Checks

Check if your Jellyfin instance is running the latest version or what OS it is on.

Playback Tracking

Keep your media server updated on where you left off in a movie.

User Auditing

List all users on your system to see who has access.

Automate a task

Put Jellyfin 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

Jellyfin 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 Jellyfin 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

970ms average. Fast in production.

Jellyfin is checked daily against the live service.

Daily averagePeak 1329ms

Oct 3Today

Fastest day: 728ms
Slowest day: 1329ms
14-day trend: Improving-7%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 12 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 Jellyfin, so you can see the experience inside your AI.

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

Jellyfin Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_4cabjqy5fZJBpV6YThVzNkYvEGnRf5hc4dAPZFEO/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 — Jellyfin capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "jellyfin-plex-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_4cabjqy5fZJBpV6YThVzNkYvEGnRf5hc4dAPZFEO/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 Jellyfin in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Jellyfin owners hand off.

This MCP is built for people running their own media infrastructure who want to interact with it via text.

01
Media Enthusiasts
People who want to browse their self-hosted collections without opening a browser.
02
Home Lab Users
Users who need to monitor server health and system info through an AI agent.
03
Developers
Engineers testing Jellyfin API calls and metadata retrieval using natural language.

FAQ

Questions Jellyfin owners ask.

01
How do I connect my Jellyfin server?
You need your Jellyfin Server URL and an API Key. Once you enter these into the Vinkius setup, the MCP is ready to use.
02
Which AI clients can I use with this MCP?
You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.
03
Can I manage users with this capability?
Yes, the MCP includes capabilities to list users and authenticate via name and password.
04
Does this work with Plex?
No, this specific MCP is designed for Jellyfin media servers.
05
Is my data secure?
Vinkius hosts the MCP and manages your credentials securely so you can connect your client once and stay connected.
06
Can I filter my library to only show Movies or Series?
Yes! Use the list_items capability and provide 'Movie' or 'Series' in the include_item_types parameter to filter your results accordingly.
07
How do I check if my Jellyfin server is running the latest version?
You can use the get_system_info capability. It returns the server version, operating system, and other vital system metrics.
08
Can I see all the root libraries configured on my server?
Absolutely. Run the list_virtual_folders capability to retrieve a list of all top-level libraries like Movies, TV Shows, and Music.

Explore

More in Loved By Devs

Connect Jellyfin to Claude, Cursor, ChatGPT & more

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

List users

Authenticate by name

Get item

Get current user

05-08

Get playback info

Get system info

Session playing progress

List items

09-12

List virtual folders

Get system configuration

Session playing

Session playing stopped

What teams actually run

Quick Library Searches

Server Health Checks

Playback Tracking

User Auditing

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

Jellyfin Connector

Claude Desktop

Media Enthusiasts

Home Lab Users

Developers

How do I connect my Jellyfin server?

Which AI clients can I use with this MCP?

Can I manage users with this capability?

Does this work with Plex?

Is my data secure?

Can I filter my library to only show Movies or Series?

How do I check if my Jellyfin server is running the latest version?

Can I see all the root libraries configured on my server?

Plex AI Connector

Cloudflare Stream AI Connector

api.video AI Connector

api.video AI Connector

Suggestions

Cockpit (Self-hosted Headless CMS API) AI Connector

Livepeer (Decentralized Video) AI Connector

Brightcove AI Connector

Vidyard AI Connector