Plex

by konsumer

267 downloads
Not rated
GitHub

About

Many new actions related to your plex library (see what you have, get suggested filenames, get media-info)

Details

Author
konsumer
Downloads
267
Categories
Other, Media

- List and search Plex libraries (movies, TV, music).
- Get detailed show/movie/artist information.
- View on-deck and in-progress content.
- Find missing episodes via TMDB.
- Manage qBittorrent torrents (add, list, search).
- Automate downloads with RSS feed rules.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Plex
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via skills with npx skills add konsumer/aitorrent and configure environment variables (Plex URL/token, qBittorrent URL/credentials, TMDB API key). Alternatively, add the three MCP servers (plex-info, tmdb-info, qbt-info) to your LLM client’s MCP settings with uvx commands. Use the CLI tools directly with uvx --from aitorrent for quick queries.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "plex": {
            "plex": {
                "command": "uvx",
                "args": [
                    "--from",
                    "aitorrent",
                    "aitorrent-plex"
                ],
                "env": {
                    "PLEX_URL": "http://localhost:32400",
                    "PLEX_TOKEN": "your_plex_token_here",
                    "TMDB_API_KEY": "your_tmdb_api_key_here"
                }
            }
        }
    }
}

McpServers

{
    "plex": {
        "command": "uvx",
        "args": [
            "--from",
            "aitorrent",
            "aitorrent-plex"
        ],
        "env": {
            "PLEX_URL": "http://localhost:32400",
            "PLEX_TOKEN": "your_plex_token_here",
            "TMDB_API_KEY": "your_tmdb_api_key_here"
        }
    }
}

Edit .env with your Plex URL and token


Plex Token: Sign in at https://app.plex.tv, click any media item, click the three dots, select "Get Info", click "View XML" (bottom-left), and copy the X-Plex-Token value from the URL bar.

TMDB API Key (Optional): For finding missing episodes and searching for shows not in your library:

1. Create a free account at https://www.themoviedb.org
2. Go to Settings > API (https://www.themoviedb.org/settings/api)
3. Click "Request an API Key" (if you haven't already)
4. Choose "Developer" and fill out the form (you can use "Personal project" for the application type)
5. Once approved, copy the API Key (v3 auth) value (NOT the "API Read Access Token")
6. Add it to .env as TMDB_API_KEY=your_key_here

Important: Use the "API Key (v3 auth)" field, which is a 32-character hexadecimal string. The "API Read Access Token" (JWT format starting with "eyJ") won't work with this tool.

qBittorrent: Make sure qBittorrent is running with Web UI enabled. Default credentials are admin/adminadmin, configured in Tools > Options > Web UI.

Tools

CLI Usage

You can run the CLI tools directly without installation using uvx:

sh

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.