An MCP server that integrates with Radarr and Sonarr to manage your media library.
Current Features:
- Browse your movie and TV show library
- Search and filter media by year and genre
- Request downloads for movies and TV shows
- Check download and monitoring status
- System health monitoring and management
- Disk space monitoring
- System health checks
- Status reporting
- Install dependencies:
pnpm installTo install MCParr Server globally on your system:
pnpm run install-globalThis will make the mcparr command available globally in your terminal.
- Set up environment variables:
export RADARR_URL=http://your-radarr-instance:7878
export RADARR_API_KEY=your-radarr-api-key
export SONARR_URL=http://your-sonarr-instance:8989
export SONARR_API_KEY=your-sonarr-api-keyAlternatively, you can create a .env file in your project directory with these variables.
Build and run the server:
pnpm run build
pnpm startFor development:
pnpm run devIf installed globally, simply run:
mcparrSearch for movies or TV shows with filters:
{
mediaType: "movie" | "series", // Required
year?: number, // Optional
genre?: string // Optional
}Request a download for specific media:
{
mediaType: "movie" | "series", // Required
id: number // Required
}Check the status of specific media:
{
mediaType: "movie" | "series", // Required
id: number // Required
}Get system health and storage information:
{
system: "radarr" | "sonarr" | "both" // Required - Which system to check
}Response includes:
- System status (version, uptime, etc.)
- Disk space information
- Health check results
Media is exposed as resources with the following URI schemes:
- Movies:
radarr://movie/{id} - TV Shows:
sonarr://series/{id}
Each resource includes:
- Title
- Year
- Current status