Plex MCP Server logo

Plex MCP Server

by djbriane

The Plex MCP Server is a Python-based server that integrates with the Plex Media Server API. It allows you to search for movies and manage playlists on your Plex server.

View on GitHub

Last updated: N/A

What is Plex MCP Server?

The Plex MCP Server is a Python application that acts as a Media Control Protocol (MCP) server for Plex. It leverages the PlexAPI library to interact with your Plex Media Server, providing an interface for searching movies, managing playlists, and retrieving media details.

How to use Plex MCP Server?

To use the Plex MCP Server, you need to clone the repository, install the dependencies using uv, configure environment variables for your Plex server (PLEX_TOKEN and PLEX_SERVER_URL), and then run the server. Configuration for use with Claude is provided in the README. Once running, you can use the exposed commands to interact with your Plex server.

Key features of Plex MCP Server

  • Movie searching

  • Playlist management (creation, deletion, adding items)

  • Retrieving movie details

  • Listing playlists

  • Getting playlist items

  • Retrieving recently added movies

Use cases of Plex MCP Server

  • Integrating Plex media management into other applications

  • Automating playlist creation and maintenance

  • Building custom Plex interfaces

  • Searching for movies and retrieving details programmatically

FAQ from Plex MCP Server

How do I find my Plex token?

Sign in to Plex Web App, open Developer Tools, and in the Console tab, paste and run: window.localStorage.getItem('myPlexAccessToken')

What is the PLEX_SERVER_URL?

It's the URL of your Plex Media Server, e.g., http://192.168.1.100:32400

What is uv?

uv is a fast, modern Python package installer and resolver, designed as a drop-in replacement for pip and pip-tools.

What commands are available?

Available commands include search_movies, get_movie_details, list_playlists, create_playlist, and more. See the README for a full list.

How do I test the connection to my Plex server?

Run the simple-direct-plex-test.py script to verify connectivity.