MCP.so
Sign In

Plex MCP Server

@vyb1ng

About Plex MCP Server

An implementation of MCP for the Plex API

Config

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

{
  "mcpServers": {
    "plex-mcp-vyb1ng": {
      "command": "node",
      "args": [
        "index.js"
      ]
    }
  }
}

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 that lets Claude search your Plex media libraries. It is for users who have a Plex server and want to query their content directly through Claude.

How to use Plex MCP Server?

Install dependencies with npm install, copy .env.example to .env, and set your PLEX_URL and PLEX_TOKEN. Then configure Claude Desktop by adding the MCP server entry using either npx (recommended) or a local node path. Restart Claude Desktop to activate the server. Run node index.js to test standalone.

Key features of Plex MCP Server

  • Search movies, TV shows, episodes, and music in your libraries
  • Filter results by content type
  • Configurable maximum number of search results
  • Rich formatted results with metadata

Use cases of Plex MCP Server

  • Ask Claude to find a movie you want to watch tonight
  • Search for a specific TV show episode across your libraries
  • Discover music albums or tracks from your Plex music library
  • Look up content without opening the Plex web interface

FAQ from Plex MCP Server

How do I get my Plex token?

Log into your Plex account, go to Settings > Account > Privacy, and click "Show" next to "Plex Pass Subscription". Your token will be displayed.

What content types can I search for?

You can search movies, shows, episodes, artists, albums, and tracks. The optional type parameter accepts "movie", "show", "episode", "artist", "album", or "track".

How do I configure this server with Claude Desktop?

Open Claude Desktop settings (Cmd/Ctrl + ,), go to the MCP Servers tab, add a configuration with the npx or node command and your Plex URL/token, then restart Claude Desktop.

What environment variables are required?

You must set PLEX_URL (e.g., http://your-plex-server:32400) and PLEX_TOKEN (your authentication token) in a .env file.

Is there a limit on search results?

Yes, you can set the limit parameter (default 10). The maximum is not specified in the README.

Frequently asked questions

How do I get my Plex token?

Log into your Plex account, go to Settings > Account > Privacy, and click "Show" next to "Plex Pass Subscription". Your token will be displayed.

What content types can I search for?

You can search movies, shows, episodes, artists, albums, and tracks. The optional `type` parameter accepts "movie", "show", "episode", "artist", "album", or "track".

How do I configure this server with Claude Desktop?

Open Claude Desktop settings (Cmd/Ctrl + ,), go to the MCP Servers tab, add a configuration with the `npx` or `node` command and your Plex URL/token, then restart Claude Desktop.

What environment variables are required?

You must set `PLEX_URL` (e.g., `http://your-plex-server:32400`) and `PLEX_TOKEN` (your authentication token) in a `.env` file.

Is there a limit on search results?

Yes, you can set the `limit` parameter (default 10). The maximum is not specified in the README.

Comments

More Other MCP servers