Skip to main content
Glama
nas-mcp-server

nas-mcp-server

NAS MCP Server

MCP server for managing your media server stack: Plex, Radarr, Overseerr, Bazarr, Prowlarr, and Trakt.tv.

Use natural language to browse your library, request movies, manage subtitles, search indexers, and discover trending films.

Installation

uvx nas-mcp-server

Related MCP server: overseerr-mcp

Configuration

Add to your Claude Desktop or Claude Code MCP configuration:

{
  "mcpServers": {
    "nas-mcp-server": {
      "command": "uvx",
      "args": ["nas-mcp-server"],
      "env": {
        "PLEX_URL": "http://your-nas:32400",
        "PLEX_TOKEN": "your_plex_token",
        "RADARR_URL": "http://your-nas:7878",
        "RADARR_API_KEY": "your_radarr_api_key",
        "OVERSEERR_URL": "http://your-nas:5055",
        "OVERSEERR_API_KEY": "your_overseerr_api_key",
        "BAZARR_URL": "http://your-nas:6767",
        "BAZARR_API_KEY": "your_bazarr_api_key",
        "PROWLARR_URL": "http://your-nas:9696",
        "PROWLARR_API_KEY": "your_prowlarr_api_key",
        "TRAKT_CLIENT_ID": "your_trakt_client_id"
      }
    }
  }
}

Note: Only configure the services you use. Each service is optional and will be disabled if not configured.

Environment Variables

Variable

Description

Required

PLEX_URL

Plex server URL (e.g., http://192.168.1.100:32400)

Yes

PLEX_TOKEN

Plex authentication token (how to find)

Yes

RADARR_URL

Radarr server URL (e.g., http://192.168.1.100:7878)

No

RADARR_API_KEY

Radarr API key (Settings → General → API Key)

No

OVERSEERR_URL

Overseerr server URL (e.g., http://192.168.1.100:5055)

No

OVERSEERR_API_KEY

Overseerr API key (Settings → General → API Key)

No

BAZARR_URL

Bazarr server URL (e.g., http://192.168.1.100:6767)

No

BAZARR_API_KEY

Bazarr API key (Settings → General → API Key)

No

PROWLARR_URL

Prowlarr server URL (e.g., http://192.168.1.100:9696)

No

PROWLARR_API_KEY

Prowlarr API key (Settings → General → API Key)

No

TRAKT_CLIENT_ID

Trakt.tv Client ID (create app)

No

Features

🎬 Plex - Your Media Library

Browse and explore your personal media collection.

  • List movies and TV shows in your library

  • Get detailed information about any title

  • Check watch status and progress

  • View active streaming sessions

  • Get personalized recommendations based on your library

🎥 Radarr - Movie Management

Automate movie downloads and organization.

  • Search and add movies to your collection

  • Monitor download progress and queue

  • Manage movie quality profiles

  • Remove movies from monitoring

  • Check disk space and system status

🎭 Overseerr - Discovery & Requests

Discover new content and manage requests.

  • Search for actors and view their complete filmography

  • Find which movies from an actor are missing from your library

  • Browse popular and trending movies

  • Submit and manage movie/TV show requests

  • Check request status and approval history

📝 Bazarr - Subtitle Management

Automate subtitle downloads for your media.

  • List movies and episodes with missing subtitles

  • Search and download subtitles in any language

  • View subtitle download history

  • Manage subtitle providers (OpenSubtitles, Addic7ed, etc.)

  • Sync with Radarr/Sonarr libraries

  • Reset throttled providers

🔍 Prowlarr - Indexer Management

Centralized indexer management for your *arr apps.

  • List and manage all configured indexers

  • Test indexer connectivity

  • Search across all indexers simultaneously

  • View indexer statistics and performance

  • Manage connected applications (Radarr, Sonarr, etc.)

  • Monitor indexer health

Discover what's popular and trending worldwide.

  • Get trending movies (most watched right now)

  • Browse popular movies (highest rated + most votes)

  • View most watched movies by period (weekly, monthly, yearly)

  • Search the Trakt database

🔧 Unified Tools

High-level tools that combine multiple services.

  • System Health Check: Get a unified status report of all your services

  • Discover Top Rated Missing: Find highly-rated movies you don't have yet, with genre filtering

Example Queries

Once configured, you can ask Claude things like:

  • "What movies do I have with Tom Hanks?"

  • "Show me my recently added movies"

  • "What's downloading right now?"

  • "Find movies with Timothée Chalamet that I don't have"

  • "Download French subtitles for Inception"

  • "What are the trending movies this week?"

  • "Show me the top 10 missing movies excluding horror and animation"

  • "Check the health of all my services"

  • "Search for 'Dune' on my indexers"

  • "Which subtitle providers are working?"

How to Get API Keys

Plex Token

  1. Sign in to Plex Web App

  2. Browse to any media item

  3. Click "Get Info" → "View XML"

  4. Find X-Plex-Token in the URL

Radarr / Sonarr / Prowlarr / Bazarr API Key

  1. Open the application web UI

  2. Go to Settings → General

  3. Copy the API Key

Overseerr API Key

  1. Open Overseerr web UI

  2. Go to Settings → General

  3. Copy the API Key

Trakt Client ID

  1. Go to Trakt API Applications

  2. Create a new application

  3. Copy the Client ID

License

MIT

Available Tools

12 tools
discover_top_rated_missingA

Découvre les films bien notés que tu n'as pas encore dans ta collection.

Args: source: Source Trakt (popular, trending, watched) period: Période pour 'watched' (weekly, monthly, yearly, all) min_imdb_rating: Note IMDB minimum (défaut: 6.0) limit: Nombre de films à retourner (défaut: 10) exclude_genres: Liste de genres à exclure (ex: ["animation", "anime"])

Inputs: source, period, min_imdb_rating, limit, +1 more. Returns: result

plex_get_librariesA

Liste toutes les bibliothèques Plex (Films, Séries, Musique, etc.).

Inputs: no named parameters. Returns: result

plex_get_movie_detailsB

Récupère les détails complets d'un film ou d'une série.

Args: rating_key: L'identifiant du média

Inputs: rating_key (required). Returns: result

plex_get_on_deckA

Récupère les médias 'À suivre' (en cours de visionnage, à reprendre).

Inputs: no named parameters. Returns: result

plex_get_recently_addedC

Récupère les médias récemment ajoutés à la bibliothèque.

Args: limit: Nombre maximum de résultats

Inputs: limit. Returns: result

plex_get_recommendationsB

Récupère des recommandations basées sur un film ou une série.

Args: rating_key: L'identifiant du média (obtenu via plex_search ou autres outils)

Inputs: rating_key (required). Returns: result

plex_get_unwatchedA

Récupère les films ou séries non vus.

Args: library_key: Clé de la bibliothèque (optionnel, utiliser plex_get_libraries pour trouver les clés) limit: Nombre maximum de résultats

Inputs: library_key, limit. Returns: result

plex_get_watchedA

Récupère l'historique de visionnage (films et séries déjà vus).

Args: limit: Nombre maximum de résultats

Inputs: limit. Returns: result

plex_search_moviesA

Recherche avancée de films dans la bibliothèque Plex avec filtres combinés.

Tous les critères sont combinés avec une logique AND.

Args: library_key: Clé de bibliothèque (optionnel, sinon toutes les bibliothèques de films) actor: Nom de l'acteur (ex: "Brad Pitt") director: Nom du réalisateur (ex: "Steven Spielberg") genre: Genre du film (ex: "Action", "Comedy", "Drama") year: Année de sortie exacte (ex: 2023) year_min: Année minimum (ex: 2000) year_max: Année maximum (ex: 2023) min_rating: Note IMDB minimum (ex: 7.0) watch_status: "watched", "unwatched", ou None pour tous added_within_days: Films ajoutés dans les X derniers jours (ex: 30) sort_by: Tri des résultats (audienceRating:desc, addedAt:desc, year:desc, title:asc) limit: Nombre maximum de résultats

Exemples: - Films avec Brad Pitt non vus: actor="Brad Pitt", watch_status="unwatched" - Comédies bien notées des 5 dernières années: genre="Comedy", year_min=2019, min_rating=7.0 - Films ajoutés ce mois-ci: added_within_days=30

Inputs: library_key, actor, director, genre, +8 more. Returns: result

plex_server_statusA

Récupère les informations et le statut du serveur Plex.

Inputs: no named parameters. Returns: result

system_health_checkA

Vérifie l'état de santé de tous les services du NAS.

Retourne un rapport unifié avec le statut de chaque service (Plex, Radarr, Overseerr, Bazarr, Prowlarr).

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between plex_search and plex_search_movies, both handling search with different levels of filtering. However, descriptions clarify the differences, and the remaining tools (discover, health check) are well-separated.

    Naming Consistency4/5

    The naming follows a consistent snake_case pattern, but there is a mix of prefixes: 'plex_', 'discover_', and 'system_'. Within the Plex group, naming is consistent (verb_noun). The 'discover_top_rated_missing' breaks from the 'plex_' prefix, causing minor inconsistency.

    Tool Count5/5

    12 tools is a reasonable count for a NAS media server focused on Plex functionality. The set covers browsing, searching, recommendations, status checks, and a unique discovery feature, without being overwhelming or too sparse.

    Completeness3/5

    The tool set covers many Plex operations (retrieve, search, recommend) but lacks media management capabilities (add, update, delete) and direct interaction with other services (Radarr, etc.) beyond a health check. Notable gaps for a full-featured NAS server.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      An MCP server that gives AI assistants control over your Sonarr, Radarr, Prowlarr, qBittorrent, and Jellyfin homelab media stack.
      8
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      MCP server for Overseerr that enables searching, requesting, and managing media (movies and TV shows) through natural language, with integration to Radarr/Sonarr for automated downloads.
      -
    • F
      license
      A
      quality
      D
      maintenance
      MCP server for Overseerr media request management. Enables AI assistants to search for media, view requests, and manage media requests through the Model Context Protocol.
      12
      -