Plex MCP Server

Get Plex server logs. Args: num_lines: Number of log lines (or matches) to retrieve (default: 100) log_type: Type of log to retrieve (server, scanner, transcoder, updater) or specific filename/partial match start_line: Starting line number to retrieve (0-indexed). If None, retrieves last num_lines. …

Get detailed information about the Plex server. Returns: Dictionary containing server details including version, platform, etc.

Get bandwidth statistics from the Plex server. Args: timespan: Time span for bandwidth data (months, weeks, days, hours, seconds) lan: Filter by local network (true/false) Returns: Dictionary containing bandwidth statistics

Get resource usage information from the Plex server. Returns: Dictionary containing resource usage statistics

Get information about Plex Butler tasks. Returns: Dictionary containing information about scheduled and running butler tasks

Get real-time alerts from the Plex server by listening on a websocket. Args: timeout: Number of seconds to listen for alerts (default: 15) Returns: Dictionary containing server alerts and their details

Manually run a specific Plex Butler task now. Args: task_name: Name of the butler task to run Returns: Success or error message

Empty trash for a specific library or all libraries. This permanently deletes all items that have been marked for deletion. Args: library_name: Optional name of the library to empty trash for. If not provided, empties trash for all libraries. Returns: Success or error message

Optimize the Plex database. This runs database optimization to improve performance and reduce database size. Returns: Success or error message

Clean unused media bundles. This removes unused media bundles (metadata, artwork) that are no longer associated with any media items. Returns: Success or error message

List all available Plex clients including idle players. Uses myPlexAccount.resources() to discover all players (both active and idle), not just those with active sessions. Args: include_details: Whether to include detailed information about each client active_only: If True, only return clients that …

Get detailed information about a specific Plex client. Args: client_name: Name or machineIdentifier of the client to get details for Returns: Dictionary containing client details

Get the current timeline information for a specific Plex client. Args: client_name: Name or machineIdentifier of the client to get timeline for Returns: Timeline information for the client

Start playback of media on a specified client. Args: media_title: Title of the media to play (optional if rating_key is provided) client_name: Optional name of the client to play on (will prompt if not provided) offset: Optional time offset in milliseconds to start from library_name: Optional name o…

Control playback on a specified client. Args: client_name: Name of the client to control (use machine identifier or title from client_list) action: Action to perform (play, pause, stop, skipNext, skipPrevious, stepForward, stepBack, seekTo, seekForward, seekBack, mute, unmute, setVolume) parameter: …

Navigate a Plex client interface. Args: client_name: Name or machineIdentifier of the client to navigate action: Navigation action to perform (moveUp, moveDown, moveLeft, moveRight, select, back, home, contextMenu)

Set audio, subtitle, or video streams for current playback on a client. Args: client_name: Name or machineIdentifier of the client to set streams for audio_stream_id: ID of the audio stream to switch to subtitle_stream_id: ID of the subtitle stream to switch to, use '0' to disable video_stream_id: I…

List all collections on the Plex server or in a specific library. Args: library_name: Optional name of the library to list collections from

Create a new collection with specified items. Args: collection_title: Title for the new collection library_name: Name of the library to create the collection in item_titles: List of media titles to include in the collection (optional if item_ids is provided) item_ids: List of media IDs to include in…

Add items to an existing collection. Args: collection_title: Title of the collection to add to (optional if collection_id is provided) collection_id: ID of the collection to add to (optional if collection_title is provided) library_name: Name of the library containing the collection (required if usi…

Remove items from a collection. Args: collection_title: Title of the collection to remove from (optional if collection_id is provided) collection_id: ID of the collection to remove from (optional if collection_title is provided) library_name: Name of the library containing the collection (required i…

Delete a collection. Args: collection_title: Title of the collection to delete (optional if collection_id is provided) collection_id: ID of the collection to delete (optional if collection_title is provided) library_name: Name of the library containing the collection (required if using collection_ti…

Comprehensively edit a collection's attributes. Args: collection_title: Title of the collection to edit (optional if collection_id is provided) collection_id: ID of the collection to edit (optional if collection_title is provided) library_name: Name of the library containing the collection (required…

List all available libraries on the Plex server.

Get statistics for a specific library. Args: library_name: Name of the library to get stats for

Refresh a specific library or all libraries. Args: library_name: Optional name of the library to refresh (refreshes all if None)

Scan a specific library or part of a library. Args: library_name: Name of the library to scan path: Optional specific path to scan within the library

Get detailed information about a specific library, including folder paths and settings. Args: library_name: Name of the library to get details for

Get recently added media across all libraries or in a specific library. Args: count: Number of items to return (default: 50) library_name: Optional library name to limit results to

Get the filtered and paginated contents of a specific library. Args: library_name: Name of the library to get contents from unwatched: If True, only return unwatched items watched: If True, only return watched items sort: Sort order (e.g., 'addedAt:desc', 'title:asc') offset: Number of items to skip…

Search for media across all libraries. Args: query: Search term to look for content_type: Optional content type to limit search to (movie, show, episode, track, album, artist or use comma-separated values for HTTP API like movies,music,tv)

Get detailed information about a specific media item using PlexAPI's Media and Mixin functions. Args: media_title: Title of the media to get details for (optional if media_id is provided) media_id: Plex media ID/rating key to directly fetch the item (optional if media_title is provided) library_name…

Edit metadata for a specific media item. Args: media_title: Title of the media to edit library_name: Optional library name to limit search to new_title: New title for the item new_summary: New summary/description new_rating: New rating (0-10) new_release_date: New release date (YYYY-MM-DD) new_genre…

Get images for a specific media item. Args: media_title: Title of the media to get images for (optional if media_id is provided) media_id: ID of the media to get images for (optional if media_title is provided) library_name: Optional library name to limit search to when using media_title image_types…

Delete a media item from the Plex library. Args: media_title: Title of the media to delete (optional if media_id is provided) media_id: ID of the media to delete (optional if media_title is provided) library_name: Optional library name to limit search to when using media_title

Set artwork for a specific media item. Args: media_title: Title of the media to set artwork for library_name: Optional library name to limit search to art_type: Type of artwork to set (poster, background/art, logo) filepath: Path to the local image file url: URL to the image file lock: Whether to lo…

List all available artwork for a specific media item. Args: media_title: Title of the media to list artwork for (optional if media_id is provided) media_id: ID of the media to list artwork for (optional if media_title is provided) library_name: Optional library name to limit search to when using med…

List all playlists on the Plex server. Args: library_name: Optional library name to filter playlists from content_type: Optional content type to filter playlists (audio, video, photo)

Create a new playlist with specified items. Args: playlist_title: Title for the new playlist item_titles: List of media titles to include in the playlist library_name: Optional library name to limit search to summary: Optional summary description for the playlist

Edit a playlist's details such as title and summary. Args: playlist_title: Title of the playlist to edit (optional if playlist_id is provided) playlist_id: ID of the playlist to edit (optional if playlist_title is provided) new_title: Optional new title for the playlist new_summary: Optional new sum…

Upload a poster image for a playlist. Args: playlist_title: Title of the playlist to set poster for (optional if playlist_id is provided) playlist_id: ID of the playlist to set poster for (optional if playlist_title is provided) poster_url: URL to an image to use as poster poster_filepath: Local fil…

Copy a playlist to another user account. Args: playlist_title: Title of the playlist to copy (optional if playlist_id is provided) playlist_id: ID of the playlist to copy (optional if playlist_title is provided) username: Username of the user to copy the playlist to

Add items to a playlist. Args: playlist_title: Title of the playlist to add to (optional if playlist_id is provided) playlist_id: ID of the playlist to add to (optional if playlist_title is provided) item_titles: List of media titles to add to the playlist (optional if item_ids is provided) item_ids…

Remove items from a playlist. Args: playlist_title: Title of the playlist to remove from (optional if playlist_id is provided) playlist_id: ID of the playlist to remove from (optional if playlist_title is provided) item_titles: List of media titles to remove from the playlist

Delete a playlist. Args: playlist_title: Title of the playlist to delete (optional if playlist_id is provided) playlist_id: ID of the playlist to delete (optional if playlist_title is provided)

Get the contents of a playlist. Args: playlist_title: Title of the playlist to get contents of (optional if playlist_id is provided) playlist_id: ID of the playlist to get contents of (optional if playlist_title is provided) Returns: JSON object containing the playlist contents

Get information about current playback sessions, including IP addresses. Args: unused: Unused parameter to satisfy the function signature

Get playback history for a specific media item. Args: media_title: Title of the media to get history for (optional if media_id is provided) library_name: Optional library name to limit search to media_id: Plex media ID/rating key to directly fetch the item (optional if media_title is provided)

Search for users with names, usernames, or emails containing the search term, or list all users if no search term is provided. Args: search_term: Optional term to search for in user information

List all users (owner, home users, and shared users) with their IDs and types. This is useful for getting the correct user IDs to filter watch history, especially for home users.

Get detailed information about a specific Plex user. Args: username: Optional. Name of the user to get information for. Defaults to the authenticated owner.

Get on deck (in progress) media for a specific user. Args: username: Name of the user to get on-deck items for

Get items the user has partially watched and can continue. Unlike on_deck which shows the next unwatched episode in a series, continue_watching shows items that were started but not finished. Args: limit: Maximum number of items to return (default 10) Returns: List of partially-watched items with pr…

Get recent watch history for a specific user. Args: username: Name of the user to get watch history for (ignored if user_id is provided) limit: Maximum number of recently watched items to show content_type: Optional filter for content type (movie, show, episode, etc) user_id: Optional user ID to fil…

Get statistics about user watch activity over different time periods. Args: time_period: Time period for statistics - options: "last_24_hours", "last_7_days", "last_30_days", "last_90_days", "last_year", "all_time" username: Optional. Filter statistics for a specific user. If not provided, returns s…