SkillFoxx

Plex MCP Server

Plex MCP Server controls Plex libraries, playlists and playback from Claude, ChatGPT and other MCP clients.

  • 160 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • The Plex admin token is kept in client settings or `.env`.
  • Tools exist for deleting media, emptying trash and running maintenance tasks.
All reasons and checks

vladimir-tutin/plex-mcp-serverAuthor:vladimir-tutin

Install

Manual install

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

The first README install option, run without installing. Replace the example address and token with your own.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The Plex admin token is kept in client settings or `.env`.
  • Tools exist for deleting media, emptying trash and running maintenance tasks.

This is third-party code. Review the repository files before installing.

What it does

The Plex MCP server gives an agent control of a media library through the Plex API. Tools are split into modules: libraries with statistics and metadata refresh, media search and details, watchlists, playlists (including smart ones), collections, users, active sessions, playback clients and server maintenance. Through clients an agent can start, pause and seek playback and switch audio tracks and subtitles. Admins get Plex log reading, bandwidth statistics and Butler task runs. Transports: stdio, SSE and Streamable HTTP. OAuth 2.1 is built in for remote clients such as Claude.ai.

Who it is for. Home Plex server owners who want to tidy the library and start films by voice or text.

Good fit when

  • A smart playlist by genre and year is needed.
  • An agent checks what was recently added to the library.
  • Starting a film on the TV from the sofa with one sentence.
  • An admin reviews server load and logs.

Not a fit when

  • The server would be shared with outsiders without OAuth.
  • The Plex token cannot be kept in client settings.
  • An agent must not receive media deletion rights.

Example request

Show what was added to the movie library this week and build an evening playlist from the new items without deleting anything.

MCP

Transport
stdio, http
Authentication
API key

Environment variables

`PLEX_URL` required
Plex server address, for example `http://localhost:32400`.
`PLEX_TOKEN` required, secret
Plex authentication token.
`MCP_OAUTH_ENABLED`
Enables OAuth 2.1 for remote clients, off by default.

Limitations

The server needs a Plex address and an admin token, and the token sits in client settings or `.env`, so keep that file private. Without OAuth anyone who reaches the port can use the tools. They include media deletion, emptying trash, database optimisation and Butler task runs: confirm such calls by hand. Claude.ai and ChatGPT need a public HTTPS address and an external OAuth provider, because the server creates neither DNS nor a certificate.

How to disable. Remove the server entry from client settings, stop the container or process and reset the Plex token in your account.

FAQ

How do I pass the Plex address and token?

Three ways: the `--plex-url` and `--plex-token` arguments, the `PLEX_URL` and `PLEX_TOKEN` variables in `.env`, or the server block in client settings.

Is there a Docker image?

Yes, `ghcr.io/vladimir-tutin/plex-mcp-server:latest` for amd64 and arm64. It runs as non-root and uses the Plex API, so no media folders need mounting.

How do I connect Claude.ai?

You need a public HTTPS address, an OAuth provider and the variables `MCP_OAUTH_ENABLED`, `MCP_OAUTH_ISSUER`, `MCP_OAUTH_AUDIENCE`. The client address is `/sse` or `/mcp`.

Which transports are supported?

stdio, SSE and Streamable HTTP; in the container streaming HTTP on port 3001 is the default.

Which operations are risky?

Deleting media, `server_empty_trash`, `server_optimize_database` and `server_run_butler_task`. Confirm such calls by hand.

Discussion

No questions or reviews yet.

MCP servers

An MCP server giving an agent Plex, Sonarr, Radarr and Trakt: library, viewing stats, recommendations and download queue.

MCP serverBroad access57
Official

Personal recommendation rows for each Plex user, with MCP access that lets an agent configure and run them

MCP serverExtended access111

A Spotify MCP server: the agent searches music, controls playback, queue and volume, and builds and edits playlists and the library

MCP serverBroad access506

MCP server that drives local Adobe Premiere Pro projects from Claude, Codex and other MCP clients

MCP serverExtended access858
Official

RunAPI MCP server: a catalog of 160 models for images, video, music and speech, pricing, task runs and balance

MCP serverExtended access56

MCP server of the 37Studio video studio: an agent manages brands, makes videos, posts to social networks and answers messages.

MCP serverBroad access162

README in short

The server manages Plex through its API and runs locally over stdio or over a network with OAuth 2.1. Install through `uvx`, `pip` or a ready Docker image.

README badge

Report a problem