n8n-nodes-jellyfin

This is an n8n community node that lets you use Jellyfin in your n8n workflows. It also supports being used as a tool by AI agents inside n8n's AI workflow builder.

Jellyfin is a free and open-source media server that lets you stream your personal media collection — movies, TV shows, music, and more — from anywhere.

n8n is a fair-code licensed workflow automation platform.

Installation Operations Credentials Compatibility Usage AI Agent Tool Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Package name: @geoffreyr/n8n-nodes-jellyfin

Operations

This node supports the following operations:

Library

• Get All Libraries - List all media library folders configured on the server
• Get Items - List items inside a library with optional filtering, sorting, and pagination
• Scan - Trigger a library scan (all libraries, or a specific one by ID)

Media

• Get - Retrieve a single item by its Jellyfin item ID
• Search - Search for items by name across all libraries
• Get Latest - Get recently added items, optionally filtered by type
• Get Playback Info - Get playback info and available media sources for an item

Credentials

This node uses API key authentication.

Setting up credentials

1. In n8n, go to Settings → Credentials
2. Click Add Credential and select Jellyfin API
3. Fill in the required fields:
   • Server URL: The base URL of your Jellyfin server (e.g. http://your-server:8096)
   • API Key: Your Jellyfin API key
   • User ID: Your Jellyfin user ID

Getting your API key

1. Open your Jellyfin dashboard
2. Go to Administration → API Keys
3. Click the + button to create a new key and give it a name (e.g. n8n)
4. Copy the generated key

Getting your User ID

1. Open your Jellyfin dashboard
2. Go to Administration → Users
3. Click on the user you want to use
4. Copy the ID from the browser URL (the long alphanumeric string at the end)

Compatibility

• Minimum n8n version: Compatible with n8n workflow automation platform
• Node.js version: Requires Node.js >= 20.15
• Jellyfin version: Tested with Jellyfin 10.9+
• License: AGPL-3.0

Usage

Basic Example: List All Libraries

1. Add the Jellyfin node to your workflow
2. Select your Jellyfin API credential
3. Set Resource to Library
4. Set Operation to Get All Libraries
5. Execute — the node returns all library folders with their IDs and names

Example: Browse Items in a Library

1. First run Library → Get All Libraries to get a library ID
2. Add a second Jellyfin node with Resource = Library, Operation = Get Items
3. Paste the library ID into Parent Library ID
4. Optionally set Include Item Types (e.g. Movie) and adjust Limit / Sort By
5. The node returns a paginated list of items with full metadata

Example: Search for Media

1. Set Resource to Media
2. Set Operation to Search
3. Enter a Search Term (e.g. Breaking Bad)
4. Optionally restrict results with Include Item Types (e.g. Series)
5. Results include item IDs, names, and metadata you can use in downstream nodes

Example: Get Recently Added Items

1. Set Resource to Media
2. Set Operation to Get Latest
3. Optionally set Include Item Types and a Limit
4. The node returns the most recently added items for the configured user

Error Handling

The node includes proper error handling for common scenarios:

• Missing required fields (User ID, Item ID)
• Invalid or unreachable server URL
• Authentication failures (invalid or expired API key)
• Jellyfin API errors (item not found, access denied)

Enable Continue On Fail on the node to handle errors gracefully and keep your workflow running.

AI Agent Tool

This node is marked as usableAsTool, which means it can be attached directly to an AI Agent node in n8n's workflow builder.

How to use it with an AI Agent

1. Add an AI Agent node to your workflow
2. In the agent's Tools panel, click Add Tool and select Jellyfin
3. Configure the Jellyfin credentials on the tool node
4. The AI agent can now call any Jellyfin operation autonomously — searching for media, listing libraries, fetching playback info, and more — based on natural language instructions

Example agent prompt

"Search my Jellyfin library for Breaking Bad and return the item ID of the series."

The agent will automatically call the Media → Search operation with searchTerm = "Breaking Bad" and return the result.

Security

Because this node communicates with your media server, apply security best practices:

• Use n8n Credentials to store your API key — never paste it directly into workflow parameters
• Create a dedicated API key for n8n with a descriptive label so you can revoke it independently
• If your Jellyfin instance is publicly accessible, ensure it uses HTTPS
• Use a Jellyfin user with the minimum required permissions

Resources

• n8n community nodes documentation
• Jellyfin documentation
• Jellyfin API reference
• Repository
• Homepage