mcp-jellyfin/README.md

mcp-jellyfin

An MCP server to interface with the Jellyfin API.

Features

• Search through Jellyfin libraries (Movies, Series, etc.)
• List active user sessions and playback information

Setup

Prerequisites

• Python 3.10+
• uv (recommended) or pip

Installation

Using uv:

uv sync

Using pip:

pip install -e .

Configuration

Create a .env file based on .env.example:

cp .env.example .env

Add your Jellyfin credentials to the .env file:

• JELLYFIN_URL: Your Jellyfin server URL (e.g., http://192.168.1.10:8096)
• JELLYFIN_API_KEY: Your Jellyfin API key

Usage

To run the MCP server:

python src/jellyfin_mcp/server.py

Testing

pytest