Plex MCP Server

@vladimir-tutin

About Plex MCP Server

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

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).

Frequently asked questions

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).

Comments

Basic information

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K