Plex MCP

Name: Plex MCP
Author: djbriane

djbriane

Get started Repository

Python server for the Plex Media Server API that searches movies in your library and manages playlists.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add plex --env PLEX_SERVER_URL='<PLEX_SERVER_URL>' --env PLEX_TOKEN='<PLEX_TOKEN>' -- uv --directory FULL_PATH_TO_PROJECT run src/plex_mcp/plex_mcp.py

~/.codex/config.toml

[mcp_servers.plex]
command = "uv"
args = ["--directory", "FULL_PATH_TO_PROJECT", "run", "src/plex_mcp/plex_mcp.py"]
env = { PLEX_SERVER_URL = "<PLEX_SERVER_URL>", PLEX_TOKEN = "<PLEX_TOKEN>" }

# codex mcp add plex --env PLEX_SERVER_URL='<PLEX_SERVER_URL>' --env PLEX_TOKEN='<PLEX_TOKEN>' -- uv --directory FULL_PATH_TO_PROJECT run src/plex_mcp/plex_mcp.py

~/.cursor/mcp.json

{
  "mcpServers": {
    "plex": {
      "command": "uv",
      "args": [
        "--directory",
        "FULL_PATH_TO_PROJECT",
        "run",
        "src/plex_mcp/plex_mcp.py"
      ],
      "env": {
        "PLEX_SERVER_URL": "<PLEX_SERVER_URL>",
        "PLEX_TOKEN": "<PLEX_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "plex": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "FULL_PATH_TO_PROJECT",
        "run",
        "src/plex_mcp/plex_mcp.py"
      ],
      "env": {
        "PLEX_SERVER_URL": "<PLEX_SERVER_URL>",
        "PLEX_TOKEN": "<PLEX_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "plex": {
      "command": "uv",
      "args": [
        "--directory",
        "FULL_PATH_TO_PROJECT",
        "run",
        "src/plex_mcp/plex_mcp.py"
      ],
      "env": {
        "PLEX_SERVER_URL": "<PLEX_SERVER_URL>",
        "PLEX_TOKEN": "<PLEX_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "plex": {
      "command": "uv",
      "args": [
        "--directory",
        "FULL_PATH_TO_PROJECT",
        "run",
        "src/plex_mcp/plex_mcp.py"
      ],
      "env": {
        "PLEX_SERVER_URL": "<PLEX_SERVER_URL>",
        "PLEX_TOKEN": "<PLEX_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "plex": {
      "command": "uv",
      "args": [
        "--directory",
        "FULL_PATH_TO_PROJECT",
        "run",
        "src/plex_mcp/plex_mcp.py"
      ],
      "env": {
        "PLEX_SERVER_URL": "<PLEX_SERVER_URL>",
        "PLEX_TOKEN": "<PLEX_TOKEN>"
      }
    }
  }
}

Environment variables

PLEX_SERVER_URL
PLEX_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related