• DISCOVERY
  • NAVIGATION
  • DETAILS
  • HUMAN

How to search your media library with your AI

Connect Jellyfin to your AI client to browse your collection through natural conversation. You stop clicking through menus and start just asking for what you want to watch.

Ask AI about this page

Short answer

Can I search my Jellyfin library using AI?

Yes. Your AI uses the Jellyfin MCP to look through your virtual folders and item lists. It finds the specific movies or shows you're looking for without you ever opening a web browser.

The results

What you get

The AI handles the navigation so you don't have to.

DISCOVERY

Find specific titles

The AI scans your library to locate a single movie or episode. You get the exact details of the item you requested.

NAVIGATION

Browse your folders

Your agent looks through your virtual folder structure. It understands how your media is organized into different categories.

DETAILS

Get item info

Once a show is found, the AI pulls the specific metadata for that entry. You get the context you need to decide if it's what you wanted.

HUMAN

Decide what to watch

The AI finds the content, but you make the final call. You decide if the results match your mood or if you want to keep searching.

The workflow

What your AI does when the request arrives.

The AI translates your question into specific data requests to your Jellyfin instance.

  1. Map the library

    The AI identifies where your media lives by looking at your directory structure.

    list_virtual_folders

  2. Locate the content

    It searches through the contents of those folders to find matching titles.

    list_items

  3. Fetch details

    The AI grabs the specific metadata for the item you asked about.

    get_item

  4. Answer you

    The AI presents the found media information in plain text.

    get_item

Try it

Copy these to start.

Use these prompts to test the connection.

Starting points

These are basic ways to start. Swap out the movie or folder names for your own.

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.

  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 — 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"
    }
  }
}
Copy into chat04

  • What movies do I have in my Horror folder?

  • Find the show 'The Last of Us' in my library.

  • List all the items in my Movies folder.

  • Give me the details for the movie Interstellar.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Jellyfin once, then ask.

Follow the link to authorize the connection. Your credentials stay encrypted and secure on our end.

Connect Jellyfin to your AI

FAQ

How this task behaves.

  • 01

    Can the AI delete movies from my library?

    No. The current tools only allow the AI to read and list your media.

  • 02

    Can I use the AI to play a video?

    No. This MCP is for searching and finding information, not for streaming playback.

  • 03

    Does the AI see my login password?

    No. Your login stays encrypted and is never shared with the AI client.

  • 04

    Can the AI add new movies to my Jellyfin?

    No. There are no tools available to write or add new items to your library.

  • 05

    Will it work with my local Jellyfin server?

    Yes, as long as your server is accessible to the Vinkius host.

  • More questions about Jellyfin? The Connector page answers them. See everything the Jellyfin Connector can do

Connect Jellyfin to Claude, Cursor, ChatGPT & more