Overview
What is Plex MCP Server?
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 interaction.
How to use Plex MCP Server?
Install via Smithery or manually using uv. Configure environment variables PLEX_TOKEN and PLEX_SERVER_URL. Add the server configuration to your Claude app’s MCP settings with the command uv --directory FULL_PATH_TO_PROJECT run src/plex_mcp/plex_mcp.py. The server exposes commands like search_movies, create_playlist, etc.
Key features of Plex MCP Server
- Search movies by title, director, genre with a limit parameter
- Get detailed info and genres for any movie
- List, create, delete, and modify playlists
- Add movies to existing playlists
- Retrieve recently added movies
Use cases of Plex MCP Server
- Find all movies by a specific director in your library
- Identify movies by a director that are missing from your collection
- Create curated playlists from search results in your Plex library
- Organize and manage your Plex library via an AI assistant
FAQ from Plex MCP Server
How do I find my Plex token?
Sign in to Plex Web App, open Developer Tools, and run window.localStorage.getItem('myPlexAccessToken') in the Console.
What are the prerequisites for running Plex MCP Server?
Python 3.8 or higher, the uv package manager, and a Plex Media Server with API access.
How do I run integration tests?
Create a .env file with PLEX_SERVER_URL and PLEX_TOKEN, then run uv run pytest -m integration.
How do I configure Plex MCP Server with Claude?
Add a JSON configuration to your Claude app under mcpServers.plex with the command, args, and env fields containing PLEX_TOKEN and PLEX_SERVER_URL.
