Plex

by konsumer

267 downloads Not rated yet

GitHub

Other
Media

About

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

Explore

- 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:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
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.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

From the repository

The easiest way to set it up is with skills:

npx skills add konsumer/aitorrent

Make sure you have the env-vars in .env.example in your environment, and you should be good-to-go.

cp .env.example .env You can run the CLI tools directly without installation using uvx:

The same functionality is available as an MCP (Model Context Protocol) server for use with LLMs:

Add to your LLMs MCP settings (~/.claude.json):

{
  "mcpServers": {
    "plex-info": {
      "command": "uvx",
      "args": ["--from", "aitorrent", "aitorrent-plex", "mcp"],
      "env": {
        "PLEX_URL": "http://localhost:32400",
        "PLEX_TOKEN": "your_plex_token_here",
        "TMDB_API_KEY": "your_tmdb_api_key_here"
      }
    },
    "tmdb-info": {
      "command": "uvx",
      "args": ["--from", "aitorrent", "aitorrent-tmdb", "mcp"],
      "env": {
        "TMDB_API_KEY": "your_tmdb_api_key_here"
      }
    },
    "qbt-info": {
      "command": "uvx",
      "args": ["--from", "aitorrent", "aitorrent-qbt", "mcp"],
      "env": {
        "QBT_URL": "http://localhost:8080",
        "QBT_USERNAME": "admin",
        "QBT_PASSWORD": "adminadmin"
      }
    }
  }
}

With Claude Code, you can do this, too:

claude mcp add plex-info --transport stdio \ --env PLEX_URL=http://localhost:32400 \ --env PLEX_TOKEN=your_plex_token_here \ --env TMDB_API_KEY=your_tmdb_api_key_here \ -- uvx --from aitorrent aitorrent-plex mcp claude mcp add tmdb-info --transport stdio \ --env TMDB_API_KEY=your_tmdb_api_key_here \ -- uvx --from aitorrent aitorrent-tmdb mcp

claude mcp add qbt-info --transport stdio \ --env QBT_URL=http://localhost:8080 \ --env QBT_USERNAME=admin \ --env QBT_PASSWORD=adminadmin \ -- uvx --from aitorrent aitorrent-qbt mcp

The LLM will have access to these tools:

Library & Content:

- plex_list_libraries - List all Plex libraries with their types
- plex_list_library_content - List all content from a specific library (TV shows with seasons/episodes, movies by collection, or music by artist/album)
- plex_search - Search for media by title across all libraries or in a specific library

Detailed Information:

- plex_get_show_details - Get detailed information about a specific TV show including all seasons, episodes, and air dates (useful for finding missing episodes)
- plex_get_movie_details - Get detailed information about a specific movie including cast, genres, collections, and ratings
- plex_get_artist_details - Get detailed information about a music artist including all albums and tracks

Viewing Status & Progress:

- plex_get_on_deck - Get items currently "On Deck" (continue watching) - shows what the user is actively watching
- plex_get_in_progress_shows - Get TV shows that are partially watched with completion percentage - excellent for finding shows the user is following
- plex_get_show_watch_status - Get detailed watch status for a specific show (which episodes are watched/unwatched per season)
- plex_get_recently_added - Get recently added items

High-Level Download Helpers:

- plex_get_episodes_to_download - HIGH-LEVEL: Get all episodes that need downloading with pre-formatted search queries and download paths (minimizes context usage)
- plex_find_missing_episodes - Compare TMDB episode list with Plex library to find missing episodes (requires TMDB_API_KEY)
- plex_get_next_episodes - Get next unwatched episodes after the last one watched (requires TMDB_API_KEY)
- plex_format_torrent_query - Format show info as a torrent search query (e.g., "Star Trek Strange New Worlds 2022 S02E05 1080p")

TMDB Tools (standalone tmdb-info MCP):

- tmdb_search_shows - Search The Movie Database for TV shows by name
- tmdb_get_show_details - Get detailed show info including all seasons and episodes
- tmdb_get_season_details - Get detailed information about a specific season
- tmdb_search_movies - Search TMDB for movies by title
- tmdb_get_movie_details - Get detailed movie information

Filesystem & Download Path Management:

- plex_get_show_path - Get the actual filesystem path where a show's episodes are stored (e.g., /media/video/tv/Doctor Who)
- plex_suggest_download_path - Intelligently suggest where to download episodes (uses existing show path or library location for new shows)
- plex_list_library_subdirs - List all show folders in a library (useful for fuzzy matching or checking what exists)

qBittorrent Torrent Management:

- qbt_get_torrents - Get list of torrents with optional status filter (downloading, completed, etc.)
- qbt_get_torrent_details - Get detailed information about a specific torrent
- qbt_add_torrent - Add a torrent by magnet link or URL with optional save path and category
- qbt_get_categories - Get all torrent categories with save paths
- qbt_create_category - Create a new category (useful for organizing by show/collection)
- qbt_get_transfer_info - Get current download/upload speeds and stats

qBittorrent Search:

- qbt_search_torrents - Search for torrents using qBittorrent's installed plugins (returns magnet links sorted by seeders)
- qbt_get_search_plugins - Get list of installed search plugins
- qbt_get_downloading_episodes - HIGH-LEVEL: Parse currently downloading torrents to extract episode info (prevents duplicate downloads)

qBittorrent RSS Feed Management:

- qbt_get_rss_feeds - Get all RSS feeds and folders (use this to see what feeds are configured)
- qbt_add_rss_feed - Add a new RSS feed URL
- qbt_remove_rss_feed - Remove an RSS feed or folder
- qbt_refresh_rss_feed - Manually refresh RSS feed(s) to check for new items

qBittorrent RSS Automation:

- qbt_get_rss_rules - Get all RSS auto-download rules (shows which feeds they're attached to)
- qbt_create_show_rss_rule - Create RSS rule to auto-download new episodes of a show (can specify feeds to attach)
- qbt_attach_rule_to_feeds - Attach an existing rule to specific feeds (CRITICAL - rules won't trigger unless attached!)
- qbt_delete_rss_rule - Delete an RSS auto-download rule

With these tools, the LLM can help you with requests like:

Basic Library Management:

- "I like Breaking Bad" → Search for the show, get details, see what episodes you have
- "What shows am I currently watching?" → Get on-deck and in-progress shows to see what you're actively following
- "Find movies in the Marvel collection" → Search libraries and filter by collection
- "Show me all Tarantino movies" → Search and get details about movies in that collection
- "What albums do I have by The Beatles?" → Search artist and get full discography
- "What's new in my library?" → Get recently added content

Torrent Download Planning (with TMDB):

- "Download the next season of shows I'm watching" → Get in-progress shows → Find missing episodes → Format torrent queries
- "What episodes of The Office am I missing?" → Compare TMDB data with Plex → Generate list of missing episodes
- "I'd like to fill in my Doctor Who collection, but not the old ones" → Find missing episodes → Filter by year → Format torrent queries
- "Grab new episodes of Star Trek: Strange New Worlds" → Get next episodes → Check if aired → Format torrent query with "1080p"
- "Download S02E05-E10 of Breaking Bad in 1080p" → Format multiple torrent queries with preferred quality

Complete Workflow (Plex + qBittorrent + TMDB):

- "I'm watching Star Trek: Strange New Worlds, automatically download new episodes when they come out" →
1. plex_get_in_progress_shows() - Verify you're watching SNW
2. plex_get_next_episodes("Star Trek: Strange New Worlds") - Find S02E06 aired but missing
3. plex_get_show_path("Star Trek: Strange New Worlds") - Get existing path: /media/video/tv/Star Trek Strange New Worlds
4. plex_format_torrent_query("Star Trek Strange New Worlds", 2, 6, 2022, "1080p") - Create search query
5. _[User would search for torrent and get magnet link]_
6. qbt_add_torrent(magnet_link, save_path="/media/video/tv/Star Trek Strange New Worlds") - Download to correct folder
7. qbt_get_rss_feeds() - Check which RSS feeds are configured (e.g., "TV Shows\\ShowRSS")
8. qbt_create_show_rss_rule("Star Trek Strange New Worlds", season=2, quality="1080p", save_path="/media/video/tv/Star Trek Strange New Worlds", feed_paths=["TV Shows\\ShowRSS"]) - Auto-download future episodes from specific feed to same location

- "Fill in my Doctor Who collection but skip the old episodes" →
1. plex_find_missing_episodes("Doctor Who") - Get all missing episodes
2. plex_get_show_path("Doctor Who") - Get existing path: /media/video/tv/Doctor Who
3. Filter for episodes with air_date >= 2005 (modern Who)
4. For each missing episode: format torrent query → search → add to qBittorrent with correct save_path
5. Downloads automatically go to the existing Doctor Who folder in Plex

- "Download new show not in my library yet" →
1. plex_search("The Expanse") - Show not found in Plex
2. plex_list_library_subdirs("TV Shows") - Check existing show folders to avoid duplicates
3. plex_suggest_download_path("The Expanse", "TV Shows") - Suggests: /media/video/tv/The Expanse
4. Download episodes to suggested path
5. Plex automatically picks them up in next library scan

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:

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Edit .env with your Plex URL and token

Tools

CLI Usage

More like this

Sequential Thinking

Filesystem

EverArt

Google Maps