Plex MCP Server

Name: Plex MCP Server
Author: djbriane

@djbriane

Repository

About Plex MCP Server

Plex MCP server

Basic information

Config

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

{
  "mcpServers": {
    "plex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@djbriane/plex-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

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?

A Python-based MCP server that integrates with the Plex Media Server API to search for movies and manage playlists. It uses the PlexAPI library for interaction.

How to use Plex MCP Server?

Install via Smithery or manually using uv. Configure environment variables PLEX_TOKEN and PLEX_SERVER_URL. Add the server configuration to your Claude app’s MCP settings with the command uv --directory FULL_PATH_TO_PROJECT run src/plex_mcp/plex_mcp.py. The server exposes commands like search_movies, create_playlist, etc.

Key features of Plex MCP Server

Search movies by title, director, genre with a limit parameter
Get detailed info and genres for any movie
List, create, delete, and modify playlists
Add movies to existing playlists
Retrieve recently added movies

Use cases of Plex MCP Server

Find all movies by a specific director in your library
Identify movies by a director that are missing from your collection
Create curated playlists from search results in your Plex library
Organize and manage your Plex library via an AI assistant

FAQ from Plex MCP Server

How do I find my Plex token?

Sign in to Plex Web App, open Developer Tools, and run window.localStorage.getItem('myPlexAccessToken') in the Console.

What are the prerequisites for running Plex MCP Server?

Python 3.8 or higher, the uv package manager, and a Plex Media Server with API access.

How do I run integration tests?

Create a .env file with PLEX_SERVER_URL and PLEX_TOKEN, then run uv run pytest -m integration.

How do I configure Plex MCP Server with Claude?

Add a JSON configuration to your Claude app under mcpServers.plex with the command, args, and env fields containing PLEX_TOKEN and PLEX_SERVER_URL.