Plex MCP Server

Name: Plex MCP Server
Author: vladimir-tutin

@vladimir-tutin

Repository Homepage

About Plex MCP Server

MCP Server for Plex to allow LLMs to converse with Plex.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Plex MCP Server?

Plex MCP Server is a 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.

How to use Plex MCP Server?

Install via uvx plex-mcp-server (recommended), pip install plex-mcp-server, or from source. Configure with --plex-url and --plex-token command-line arguments, environment variables (e.g., PLEX_URL, PLEX_TOKEN), or an MCP client config file. Then invoke any of the available tools from your MCP client (e.g., Claude Desktop) to manage libraries, media, collections, playlists, clients, users, sessions, and server administration.

Key features of Plex MCP Server

Standardized API with unified JSON responses for all operations.
Supports both stdio and SSE (Server‑Sent Events) transports.
Comprehensive control over libraries, media, collections, playlists, clients, and users.
Built‑in OAuth 2.1 support for remote integration with platforms like Claude.ai.
Admin tools: access logs, monitor bandwidth, run Butler tasks.

Use cases of Plex MCP Server

Search, edit metadata, and manage media items across all libraries.
Create, modify, and share playlists and collections.
Monitor active sessions and client playback in real time.
Automate server maintenance tasks (empty trash, optimize database, clean bundles).
Remotely control Plex clients and integrate with AI agents via MCP.

FAQ from Plex MCP Server

What transports does Plex MCP Server support?

It supports both stdio (for local integration) and SSE (Server‑Sent Events, for remote access).

How do I enable OAuth for remote access?

Set MCP_OAUTH_ENABLED=true in your environment, configure MCP_OAUTH_ISSUER and MCP_SERVER_URL, then provide the OAuth Client ID and Secret to your client (e.g., Claude.ai).

What configuration is required to connect to my Plex server?

You must provide your Plex server URL and authentication token, either via the --plex-url and --plex-token command‑line arguments or the PLEX_URL and PLEX_TOKEN environment variables.

How are errors and multiple matches reported?

All tools return JSON. Success includes "status": "success" with data. Errors return "status": "error" with a message. When multiple items share a name, a list of specific identifiers is returned.

What should I do if I get a 401 Unauthorized error with OAuth?

Ensure your MCP_OAUTH_ISSUER exactly matches the issuer URL from your identity provider, including any trailing slash. Also verify that MCP_SERVER_URL is publicly reachable (HTTPS).