plex

This Plex MCP Server exposes a standardized JSON-based API to manage Plex libraries, media, playlists, collections, users, and more. It supports multiple transports, including stdio and Server-Sent Events (SSE), enabling integration with AI agents and automation pipelines. With built-in OAuth 2.1 support, you can securely connect remote agents (like Claude) and trigger tasks or retrieve Plex data through a consistent command surface. The provided command references and modules (Library, Media, Playlist, Collection, User, Sessions, Server) give you a structured set of operations to explore and manipulate your Plex media ecosystem. To start, configure the server URL and token, then connect via stdio or SSE as your environment requires, and begin issuing commands such as library_list, media_search, or playlist_create to automate common workflows.

Prerequisites:

• Python 3.9+ and pip or an environment with uvx (Python/uv) installed
• Access to install Python packages from PyPI

Option A: Install via uvx (Recommended)

1. Ensure uvx is installed and available in PATH
2. Run the server directly: uvx plex-mcp-server --transport stdio --plex-url http://your-server:32400 --plex-token your-token

Option B: Install via pip

1. Install the package from PyPI: pip install plex-mcp-server
2. Run the server (example): plex-mcp-server --transport stdio --plex-url http://your-server:32400 --plex-token your-token

Option C: Development / Source

1. Clone the repository: git clone https://github.com/vladimir-tutin/plex-mcp-server.git
2. Navigate into the project and install in editable mode: cd plex-mcp-server pip install -e .
3. Run the server as above after installation.

Environment variables can be used to configure defaults and OAuth behavior. Commonly used variables include PLEX_URL and PLEX_TOKEN. If you enable MCP_OAUTH_ENABLED, you should provide MCP_OAUTH_ISSUER and MCP_SERVER_URL for proper OAuth flow. When integrating with Claude or other connectors, ensure the connector URL over SSE matches the server's SSE endpoint and that credentials are securely stored. If you encounter connection errors, verify Plex server accessibility from the host running the MCP server and confirm the Plex token has the necessary permissions.