Integrations
Integrates with Plex Media Server API, allowing searching for movies, viewing detailed movie information, managing playlists, retrieving genres, and accessing recently added content from Plex libraries.
Plex MCP Server
This is a Python-based MCP server that integrates with the Plex Media Server API to search for movies and manage playlists. It uses the PlexAPI library for seamless interaction with your Plex server.
Screenshots
Here are some examples of how the Plex MCP server works:
1. Find Movies in Plex Library by Director
Search for movies in your Plex library by specifying a director's name. For example, searching for "Alfred Hitchcock" returns a list of his movies in your library.
2. Find Missing Movies for a Director
Identify movies by a specific director that are missing from your Plex library. This helps you discover gaps in your collection.
3. Create a Playlist in Your Plex Library
Create a new playlist in your Plex library using the movies found in a search. This allows you to organize your library efficiently.
Setup
Prerequisites
- Python 3.8 or higher
uv
package manager- A Plex Media Server with API access
Installation
Installing via Smithery
To install Plex Media Server Integration for Claude Desktop automatically via Smithery:
Installing Manually
- Clone this repository:
- Install dependencies with
uv
: - Configure environment variables for your Plex server:
PLEX_TOKEN
: Your Plex authentication tokenPLEX_SERVER_URL
: Your Plex server URL (e.g., http://192.168.1.100:32400)
Finding Your Plex Token
You can find your Plex token in this way:
- Sign in to Plex Web App
- Open Developer Tools
- In Console tab, paste and run:
Usage with Claude
Add the following configuration to your Claude app:
Available Commands
The Plex MCP server exposes these commands:
Command | Description | OpenAPI Reference |
---|---|---|
search_movies | Search for movies in your library by various filters (e.g., title, director, genre) with support for a limit parameter to control the number of results. | /library/sections/{sectionKey}/search |
get_movie_details | Get detailed information about a specific movie. | /library/metadata/{ratingKey} |
get_movie_genres | Get the genres for a specific movie. | /library/sections/{sectionKey}/genre |
list_playlists | List all playlists on your Plex server. | /playlists |
get_playlist_items | Get the items in a specific playlist. | /playlists/{playlistID}/items |
create_playlist | Create a new playlist with specified movies. | /playlists |
delete_playlist | Delete a playlist from your Plex server. | /playlists/{playlistID} |
add_to_playlist | Add a movie to an existing playlist. | /playlists/{playlistID}/items |
recent_movies | Get recently added movies from your library. | /library/recentlyAdded |
Running Tests
This project includes both unit tests and integration tests. Use the following instructions to run each type of test:
Unit Tests
Unit tests use dummy data to verify the functionality of each module without requiring a live Plex server.
To run all unit tests:
Integration Tests
Integration tests run against a live Plex server using environment variables defined in a .env file. First, create a .env file in your project root with your Plex configuration:
Integration tests are marked with the integration marker. To run only the integration tests:
If you are experiencing connection issues to your Plex server try running the integration tests to help troubleshoot.
Code Style and Conventions
- Module Structure:
Use clear section headers for imports, logging setup, utility functions, class definitions, global helpers, tool methods, and main execution (guarded byif __name__ == "__main__":
). - Naming:
Use CamelCase for classes and lower_snake_case for functions, variables, and fixtures. In tests, list built-in fixtures (e.g.monkeypatch
) before custom ones. - Documentation & Comments:
Include a concise docstring for every module, class, and function, with in-line comments for complex logic. - Error Handling & Logging:
Use Python’slogging
module with consistent error messages (prefix “ERROR:”) and explicit exception handling. - Asynchronous Patterns:
Define I/O-bound functions as async and useasyncio.to_thread()
to handle blocking operations.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Python-based MCP server that integrates with Plex Media Server API to search for movies and manage playlists in your Plex media library.
Related MCP Servers
- -securityAlicense-qualityIntegrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.Last updated 2 months ago314JavaScriptMIT License
- -securityAlicense-qualityThis MCP server integrates with Google Drive to allow listing, reading, and searching over files.Last updated a day ago1,49543,407JavaScriptMIT License
- -securityFlicense-qualityAn MCP server that enables LLMs to search YouTube, retrieve video information, and access video transcripts through standardized tools.Last updated a month agoTypeScript
- -securityFlicense-qualityIntegrates with Spotify Web API through the Model Context Protocol, allowing users to search tracks, control playback, and manage playlists programmatically.Last updated 2 months agoJavaScript