Plex MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PLEX_URL | Yes | The URL of your Plex server (e.g., http://your-plex-server:32400) | |
| PLEX_TOKEN | No | Your Plex authentication token (optional, can use OAuth instead). Get your token from https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/ | |
| MCP_HTTP_DEBUG | No | Enable comprehensive HTTP request/response logging for troubleshooting connection issues | false |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_plexC | Search for movies, TV shows, and other content in Plex libraries |
| browse_librariesB | List all available Plex libraries (Movies, TV Shows, Music, etc.) |
| browse_libraryC | Browse content within a specific Plex library with filtering and sorting options |
| get_recently_addedC | Get recently added content from Plex libraries |
| get_watch_historyC | Get playback history for the Plex server |
| get_on_deckC | Get 'On Deck' items (continue watching) for users |
| list_playlistsC | List all playlists on the Plex server |
| browse_playlistC | Browse and view the contents of a specific playlist with full track metadata |
| create_playlistA | Create a new regular playlist on the Plex server. Requires an initial item (item_key parameter) to be created successfully. Smart playlists are not supported due to their complex filter requirements. |
| add_to_playlistC | Add items to an existing playlist |
| delete_playlistC | Delete an existing playlist |
| get_watched_statusC | Check watch status and progress for specific content items |
| get_collectionsB | List all collections available on the Plex server |
| browse_collectionC | Browse content within a specific collection |
| get_media_infoB | Get detailed technical information about media files (codecs, bitrates, file sizes, etc.) |
| get_library_statsB | Get comprehensive statistics about Plex libraries (storage usage, file counts, content breakdown, etc.) |
| get_listening_statsC | Get detailed listening statistics and music recommendations based on play history and patterns |
| discover_musicB | Natural language music discovery with smart recommendations based on your preferences and library |
| authenticate_plexA | Initiate Plex OAuth authentication flow to get user login URL |
| check_auth_statusA | Check if Plex authentication is complete and retrieve the auth token |
| clear_authB | Clear stored authentication credentials |
| validate_llm_responseC | Validate LLM response format and content against expected schemas for different prompt types |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| playlist_description | Generate a creative description for a playlist |
| content_recommendation | Generate content recommendations based on viewing history or preferences |
| smart_playlist_rules | Generate smart playlist criteria and rules |
| media_analysis | Analyze and categorize media content |
| server_troubleshooting | Help diagnose Plex server connection or performance issues |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Connection Status | Current Plex server connection status |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/vyb1ng/plex-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server