Jellyfin integration
Jellyfin is a self-hosted media server for movies, shows, music, books and live TV. Query the library with the item filters the server itself uses, read and edit item metadata, refresh a single item or a whole library, list and set item images, download an item's original file, browse albums, artists, genres, studios, people, years, trailers and channels, read what is next up, upcoming, latest, suggested or resumable, manage collections and playlists and their members, mark items played or favourite and rate them, run Live TV with its channels, programs, recordings, timers and series timers, manage virtual folders and media paths, read and control active playback sessions, manage users and their policies and configuration, list and run scheduled tasks, and read server info, configuration, storage, logs and the activity log. The host is part of the credential because every install is its own deployment. Authentication is an API key sent in the X-Emby-Token header.
Say what should happen.
The workflow builds itself.
What you can do with Jellyfin
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Item, 10 operations
add_item_to_playlistAdd item to playlistPOSTAdds items to a playlist.add_to_collectionAdd to collectionPOSTAdds items to a collection.delete_itemDelete itemDELETEDeletes an item from the library and filesystem.delete_itemsDelete itemsDELETEDeletes items from the library and filesystem.get_itemGet itemGETGets an item from a user's library.list_channel_itemsList channel itemsGETGet channel items.list_itemsList itemsGETGets items based on a query.list_playlist_itemsList playlist itemsGETGets the original items of a playlist.remove_from_collectionRemove from collectionDELETERemoves items from a collection.remove_item_from_playlistRemove item from playlistDELETERemoves items from a playlist.
User, 6 operations
delete_userDelete userDELETEDeletes a user.get_playlist_shared_userGet playlist shared userGETGet a playlist user.get_userGet userGETGets a user by Id.list_playlist_shared_usersList playlist shared usersGETGet a playlist's users.list_usersList usersGETGets a list of users.remove_playlist_shared_userRemove playlist shared userDELETERemove a user from a playlist's users.
Image, 5 operations
delete_item_imageDelete item imageDELETEDelete an item's image.delete_item_image_by_indexDelete item image by indexDELETEDelete an item's image.get_item_imageGet item imageGETGets the item's image.get_item_image_by_indexGet item image by indexGETGets the item's image.list_item_imagesList item imagesGETGet item image infos.
Series timer, 4 operations
cancel_series_timerCancel series timerDELETECancels a live tv series timer.create_series_timerCreate series timerPOSTCreates a live tv series timer.get_series_timerGet series timerGETGets a live tv series timer.list_series_timersList series timersGETGets live tv series timers.
Timer, 4 operations
cancel_timerCancel timerDELETECancels a live tv timer.create_timerCreate timerPOSTCreates a live tv timer.get_timerGet timerGETGets a timer.list_timersList timersGETGets the live tv timers.
Channel, 3 operations
get_live_tv_channelGet live tv channelGETGets a live tv channel.list_channelsList channelsGETGets available channels.list_live_tv_channelsList live tv channelsGETGets available live tv channels.
Program, 3 operations
get_programGet programGETGets a live tv program.list_programsList programsGETGets available live tv epgs.query_programsQuery programsPOSTGets available live tv epgs.
Recording, 3 operations
delete_recordingDelete recordingDELETEDeletes a live tv recording.get_recordingGet recordingGETGets a live tv recording.list_recordingsList recordingsGETGets live tv recordings.
Virtual folder, 3 operations
add_virtual_folderAdd virtual folderPOSTAdds a virtual folder.list_virtual_foldersList virtual foldersGETGets all virtual folders.remove_virtual_folderRemove virtual folderDELETERemoves a virtual folder.
Artist, 2 operations
get_artistGet artistGETGets an artist by name.list_artistsList artistsGETGets all artists from a given item, folder, or the entire library.
Collection, 2 operations
create_collectionCreate collectionPOSTCreates a new collection.list_item_collectionsList item collectionsGETGets the collections that include the specified item.
Genre, 2 operations
get_genreGet genreGETGets a genre, by name.list_genresList genresGETGets all genres from a given item, folder, or the entire library.
Info, 2 operations
get_live_tv_infoGet live tv infoGETGets available live tv services.get_system_infoGet system infoGETGets information about the server.
Path, 2 operations
add_media_pathAdd media pathPOSTAdd a media path to a library.remove_media_pathRemove media pathDELETERemove a media path.
Person, 2 operations
get_personGet personGETGet person by name.list_personsList personsGETGets all persons.
Ping, 2 operations
ping_playback_sessionPing playback sessionPOSTPings a playback session.ping_serverPing serverGETPings the system.
Playback info, 2 operations
get_playback_infoGet playback infoGETGets live playback media info for an item.get_playback_info_with_optionsGet playback info with optionsPOSTGets live playback media info for an item.
Playing, 2 operations
play_on_sessionPlay on sessionPOSTInstructs a session to play an item.report_playback_startReport playback startPOSTReports playback has started within a session.
Playlist, 2 operations
create_playlistCreate playlistPOSTCreates a new playlist.get_playlistGet playlistGETGet a playlist.
Public, 2 operations
get_public_system_infoGet public system infoGETGets public information about the server.list_public_usersList public usersGETGets a list of publicly visible users for display on a login screen.
Rating, 2 operations
delete_item_ratingDelete item ratingDELETEDeletes a user's saved personal rating for an item.rate_itemRate itemPOSTUpdates a user's rating for an item.
Scheduled task, 2 operations
get_scheduled_taskGet scheduled taskGETGet task by id.list_scheduled_tasksList scheduled tasksGETGet tasks.
Studio, 2 operations
get_studioGet studioGETGets a studio by name.list_studiosList studiosGETGets all studios from a given item, folder, or the entire library.
User played item, 2 operations
mark_played_itemMark played itemPOSTMarks an item as played for user.mark_unplayed_itemMark unplayed itemDELETEMarks an item as unplayed for user.
Year, 2 operations
get_yearGet yearGETGets a year.list_yearsList yearsGETGet years.
Album artist, 1 operation
list_album_artistsList album artistsGETGets all album artists from a given item, folder, or the entire library.
Ancestor, 1 operation
list_item_ancestorsList item ancestorsGETGets all parents of an item.
Available option, 1 operation
get_library_type_optionsGet library type optionsGETGets the library options info.
Configuration, 1 operation
get_system_configurationGet system configurationGETGets application configuration.
Count, 1 operation
get_item_countsGet item countsGETGet item counts.
Countrie, 1 operation
list_localization_countriesList localization countriesGETGets known countries.
Culture, 1 operation
list_culturesList culturesGETGets known cultures.
Default, 1 operation
get_default_timerGet default timerGETGets the default values for a new timer.
Download, 1 operation
download_item_fileDownload item fileGETDownloads item media.
Entrie, 1 operation
list_activity_log_entriesList activity log entriesGETGets activity log entries.
Episode, 1 operation
list_episodesList episodesGETGets episodes for a tv season.
File, 1 operation
get_item_fileGet item fileGETGet the original file of an item.
Filter, 1 operation
get_item_filtersGet item filtersGETGets legacy query filters.
Folder, 1 operation
list_recording_foldersList recording foldersGETGets recording folders.
Grouping option, 1 operation
list_user_view_grouping_optionsList user view grouping optionsGETGet user view grouping options.
Latest, 1 operation
list_latest_itemsList latest itemsGETGets latest media.
Log, 1 operation
list_log_filesList log filesGETGets a list of available server log files.
Me, 1 operation
get_current_userGet current userGETGets the user based on auth token.
Media folder, 1 operation
list_media_foldersList media foldersGETGets all user media folders.
Media segment, 1 operation
get_media_segmentGet media segmentGETGets all media segments based on an itemId.
Merge version, 1 operation
merge_video_versionsMerge video versionsPOSTMerges videos into a single record.
Move, 1 operation
move_playlist_itemMove playlist itemPOSTMoves a playlist item.
Music genre, 1 operation
get_music_genreGet music genreGETGets a music genre, by name.
Name, 1 operation
rename_virtual_folderRename virtual folderPOSTRenames a virtual folder.
New, 1 operation
create_userCreate userPOSTCreates a user.
Next up, 1 operation
list_next_upList next upGETGets a list of next up episodes.
Parental rating, 1 operation
list_parental_ratingsList parental ratingsGETGets known parental ratings.
Physical path, 1 operation
list_physical_pathsList physical pathsGETGets a list of physical paths from virtual folders.
Progres, 1 operation
report_playback_progressReport playback progressPOSTReports playback progress within a session.
Recommendation, 1 operation
list_movie_recommendationsList movie recommendationsGETGets movie recommendations.
Recommended, 1 operation
list_recommended_programsList recommended programsGETGets recommended live tv epgs.
Refresh, 1 operation
refresh_itemRefresh itemPOSTRefreshes metadata for an item.
Resume, 1 operation
list_resumable_itemsList resumable itemsGETGets items based on a query.
Root, 1 operation
get_root_itemGet root itemGETGets the root folder from a user's library.
Season, 1 operation
list_seasonsList seasonsGETGets seasons for a tv series.
Session, 1 operation
list_sessionsList sessionsGETGets a list of sessions.
Similar, 1 operation
list_similar_itemsList similar itemsGETGets similar items.
Stopped, 1 operation
report_playback_stoppedReport playback stoppedPOSTReports playback has stopped within a session.
Storage, 1 operation
get_system_storage_infoGet system storage infoGETGets information about the server.
Subtitle, 1 operation
delete_subtitleDelete subtitleDELETEDeletes an external subtitle file.
Suggestion, 1 operation
list_suggested_itemsList suggested itemsGETGets suggestions.
Trailer, 1 operation
list_trailersList trailersGETFinds movies and trailers similar to a given trailer.
Upcoming, 1 operation
list_upcoming_episodesList upcoming episodesGETGets a list of upcoming episodes.
User data, 1 operation
get_item_user_dataGet item user dataGETGet Item User Data.
User favorite item, 1 operation
mark_favorite_itemMark favorite itemPOSTMarks an item as a favorite.
User view, 1 operation
list_user_viewsList user viewsGETGet user views.
Viewing, 1 operation
display_content_on_sessionDisplay content on sessionPOSTInstructs a session to browse to an item or view.
Showing the first 120 of 147 endpoints. The rest are in the product, searchable from the workflow builder and from chat.
Use Jellyfin from Claude Code, Cursor or Codex
Connect Jellyfin in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Jellyfin operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Jellyfin
- Create your workspace
Sign up free. Nothing to install.
- Connect Jellyfin once
Add your Jellyfin connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Jellyfin integration FAQ
What can you do with the Jellyfin integration?
LiveContext exposes 147 operations on Jellyfin, covering item, user, image and series timer.
