jhomen368/overseerr-mcp

> **A Model Context Protocol (MCP) server for Overseerr and Seerr (the unified successor) that enables AI assistants to search, request, and manage media through the Model Context Protocol.**
🎯 Key Features
- **🚀 99% fewer API calls** for batch operations (150-300 → 1)
- **⚡ 88% token reduction** with compact response formats
- **🎯 Batch Dedupe Mode** - Check 50-100 titles in one operation
- **🔄 Smart Caching** - 70-85% API call reduction
- **🛡️ Safety Features** - Multi-season confirmation, validation
- **📦 6 Tools** - Search, request, and manage media | Discover Radarr/Sonarr server configurations
🔒 Security
- **🤖 Automated Security Scanning**
- Dependabot for dependency updates (weekly)
- CodeQL for code vulnerability analysis (PR + weekly)
- Trivy for Docker image scanning (CI only - blocks PRs if vulnerabilities found)
- CI validates everything during PR review, CD trusts CI and publishes
- **🐳 Hardened Docker Images**
- Non-root user (mcpuser)
- Multi-stage builds
- Minimal Alpine base
- dumb-init process management
- **✅ Input Validation**
- URL and API key format validation
- Fails fast with clear error messages
🛠️ Available Tools
| Tool | Purpose | Key Features |
|------|---------|--------------|
| **search_media** | Search & dedupe | Single/batch search, dedupe mode for 50-100 titles, franchise awareness |
| **request_media** | Request movies/TV | Batch requests, season validation, multi-season confirmation, dry-run mode |
| **manage_media_requests** | Manage requests | List/approve/decline/delete, filtering, summary statistics |
| **get_media_details** | Get media info | Batch lookup, flexible detail levels (basic/standard/full) |
| **get_services** | List Radarr/Sonarr servers | Discover server IDs, active defaults, 4K status |
| **get_service_details** | Get server config | Quality profiles, root folders, tags per server |
📋 Prerequisites
- **Node.js** 18.0 or higher
- **Seerr or Overseerr instance** (self-hosted or managed)
- **Seerr/Overseerr API key** (Settings → General in your instance)
🚀 Quick Start
Option 1: NPM (Recommended)
**Configure with Claude Desktop:**
Add to your configuration file:
- **macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
- **Windows**: %APPDATA%\Claude\claude_desktop_config.json
> **Legacy Overseerr Users:** If you're still using Overseerr (not Seerr), you can continue using the legacy variables:
>
> *Both OVERSEERR_* and SEERR_* variables are supported for backward compatibility. Legacy variables will be removed in v3.0.0.*
Option 2: Docker (Remote Access)
**Docker Compose:**
**Test the server:**
**Connect MCP clients:**
- **Transport**: Streamable HTTP
- **URL**: http://localhost:8085/mcp
Option 3: From Source
💡 Usage Examples
Batch Dedupe Workflow (Perfect for Anime Seasons)
**Response:**
Request Media with Validation
Manage Requests
Service Discovery
Natural Language Examples
Simply ask your AI assistant:
- "Search for Inception in Seerr"