nas-mcp-server
Browse and explore personal media collection. List movies and TV shows, get detailed information, check watch status, view active streaming sessions, and get personalized recommendations.
Automate movie downloads and organization. Search and add movies, monitor download progress, manage quality profiles, remove monitoring, and check disk space.
Discover popular and trending content. Get trending and popular movies, most watched by period, and search the Trakt.tv database.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@nas-mcp-server Show me my recently added movies"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-serverRelated 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 server URL (e.g., | Yes |
| Plex authentication token (how to find) | Yes |
| Radarr server URL (e.g., | No |
| Radarr API key (Settings → General → API Key) | No |
| Overseerr server URL (e.g., | No |
| Overseerr API key (Settings → General → API Key) | No |
| Bazarr server URL (e.g., | No |
| Bazarr API key (Settings → General → API Key) | No |
| Prowlarr server URL (e.g., | No |
| Prowlarr API key (Settings → General → API Key) | No |
| 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
📈 Trakt.tv - Trending & Discovery
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
Sign in to Plex Web App
Browse to any media item
Click "Get Info" → "View XML"
Find
X-Plex-Tokenin the URL
Radarr / Sonarr / Prowlarr / Bazarr API Key
Open the application web UI
Go to Settings → General
Copy the API Key
Overseerr API Key
Open Overseerr web UI
Go to Settings → General
Copy the API Key
Trakt Client ID
Go to Trakt API Applications
Create a new application
Copy the Client ID
License
MIT
Available Tools
12 toolsdiscover_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_searchA
Recherche du contenu dans Plex par titre, acteur, réalisateur, etc.
Args: query: Terme de recherche (titre, acteur, réalisateur, genre...) media_type: Type de média à rechercher (movie, show, episode, artist, album, track). Si non spécifié, recherche tous les types.
Inputs: query (required), media_type. 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
Scored across 12 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for Producer/Riffusion AI music generation
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceAn MCP server that gives AI assistants control over your Sonarr, Radarr, Prowlarr, qBittorrent, and Jellyfin homelab media stack.8MIT
- FlicenseNot gradedqualityBmaintenanceMCP 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.-
- FlicenseAqualityDmaintenanceMCP 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-
- AlicenseBqualityDmaintenanceEnables control and management of a self-hosted media stack (Radarr, Sonarr, Prowlarr, SABnzbd, qBittorrent) through natural language via MCP.15GPL 3.0