FlixBridge

FlixBridge is an MCP server that connects your AI assistant to media management services like Sonarr, Radarr, and SABnzbd. It provides a unified interface to monitor downloads, manage libraries, and automate media workflows so you can control your media ecosystem from a single place.

How to use

You interact with FlixBridge through an MCP client to manage your TV shows, movies, and download workflows. Start by configuring your connected services in the environment, then run the server so your client can issue commands. You can check system health, monitor queues, search for new content, add media with smart quality profiles, and run diagnostics to fix stuck items. Use the MCP client to run actions across all configured services from a single interface.

How to install

# Prerequisites: ensure you have Node.js and npm installed on your system
node -v
npm -v

# Install FlixBridge globally (recommended for easy access)
npm install -g @thesammykins/flixbridge

# Or install locally in your project
mkdir my-flixbridge && cd my-flixbridge
npm init -y
npm install @thesammykins/flixbridge

Additional setup and usage notes

Configure your services using environment variables before starting FlixBridge. You can run in a multi-instance mode by defining distinct slug-based variables for each service instance. The final command to start the server is the runtime command you use after installation and build.

Configuration and multi-instance setup

FlixBridge supports slug-based configuration via environment variables to connect multiple Sonarr, Radarr, and SABnzbd instances. Use a unique slug for each instance and provide the corresponding URL and API key values. If you provide a <slug>NAME, that will override the final display name.

Security and troubleshooting

Keep your API keys and credentials secure. Run the server in a trusted network segment and monitor logs for any diagnostics. If you encounter issues, enable debug logging to gather more information and run the built-in diagnostics tools to identify and fix problems.

Notes on multiple configurations

You can configure multiple instances for different service sets (e.g., main and UHD) using slug-based environment variables. The service names default to a slugized form, but you can override them with a dedicated NAME if needed.

Available tools

list_services

Discover all configured MCP services and downloaders to understand what is available for management.

system_status

Retrieve health and version information for the running MCP server.

queue_list

Show the current download queue with progress details across all connected services.

queue_grab

Retry or grab specific items stuck in the download queue.

queue_diagnostics

Auto-detect and fix common issues in the download queue to keep workflows flowing.

root_folders

Show storage locations and free space available across your configured services.

search

Search for new TV shows and movies to add to your libraries.

add_new

Add media with intelligent quality profiles to match your preferences.

quality_profiles

List and manage the available quality configurations for new media.

history_detail

Download and import historical data for better traceability.

import_issues

Detect and import issues related to downloads to assist troubleshooting.

all_services_diagnostics

Run diagnostics across all configured instances to get a holistic view.

download_status

Provide a unified status view across services and downloaders.