Plex MCP Server

A powerful Model-Context-Protocol (MCP) server for interacting with Plex Media Server. It provides a standardized JSON-based interface for automation, AI agents (like Claude), and custom integrations.

Features

• Standardized API: Unified JSON responses for all Plex operations.
• Multiple Transports: Supports both stdio and SSE (Server-Sent Events).
• Comprehensive Control: Manage libraries, media, collections, playlists, clients, and users.
• Remote Ready: Built-in OAuth 2.1 support for integration with remote AI platforms like Claude.ai.
• Admin Tools: Access logs, monitor bandwidth, and run Butler tasks.

Installation

Option 1: Using uv (Recommended)

Run directly without installation:

uvx plex-mcp-server --transport stdio --plex-url http://your-server:32400 --plex-token your-token

Option 2: Install via pip

pip install plex-mcp-server

Option 3: Development / Source

git clone https://github.com/vladimir-tutin/plex-mcp-server.git
cd plex-mcp-server
pip install -e .

Configuration

Set your Plex server URL and Token using one of these methods:

1. Command Line Arguments

plex-mcp-server --plex-url "http://192.168.1.10:32400" --plex-token "ABC123XYZ"

2. Environment Variables (.env)

Create a .env file in the current directory or ~/.config/plex-mcp-server/.env:

PLEX_URL=http://localhost:32400
PLEX_TOKEN=your-authentication-token
MCP_OAUTH_ENABLED=false

or with OAuth Enabled

PLEX_URL=http://localhost:32400
PLEX_TOKEN=your-authentication-token
MCP_OAUTH_ENABLED=true
MCP_OAUTH_ISSUER=https://auth.example.com/application/o/plexmcp-oauth/
MCP_SERVER_URL=https://plexmcp.example.com

3. MCP Client Config

Example for Claude Desktop (%APPDATA%/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "plex": {
      "command": "uvx",
      "args": [
        "plex-mcp-server",
        "--transport",
        "stdio",
        "--plex-url",
        "http://your-server:32400",
        "--plex-token",
        "your-token"
      ]
    }
  }
}

4. Claude Connector Installation

Go to https://claude.ai/settings/connectors and add a new connector with the following settings:

• Name: Plex MCP
• URL: https://plexmcp.example.com/sse
• Add OAuth Client ID and Client Secret if OAuth is enabled

Command Reference

Library Module

Tools for exploring and managing your Plex libraries.

Command	Description	Parameters
library_list	Lists all available libraries.	None
library_get_stats	Gets statistics (count, size, types) for a library.	library_name
library_refresh	Triggers a metadata refresh for a library.	library_name
library_scan	Scans a library for new files.	library_name
library_get_details	Gets detailed information about a library.	library_name
library_get_recently_added	Lists recently added items in a library.	library_name, limit: int
library_get_contents	Lists all items in a library.	library_name, limit: int

Media Module

Tools for searching, inspecting, and editing specific media items.

Command	Description	Parameters
media_search	Search for media across all libraries.	query, library_name, content_type
media_get_details	Get comprehensive details for an item.	media_title, library_name, media_id
media_edit_metadata	Update tags, genres, summary, or title.	media_title, library_name, new_title, new_summary, new_rating, new_release_date, new_genre, remove_genre, new_director, new_studio, new_tags
media_delete	Remove an item from Plex.	media_title, library_name, media_id
`media_get_artwork

... View full README on GitHub