Plex MCP Server

@vladimir-tutin

Basic information

About Plex MCP Server

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

Plex MCP Server 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"
      ]
    }
  }
}

Plex MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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.

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

More Other MCP servers

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.