🎬 arrstack-mcp

An MCP server that gives AI assistants configurable access to homelab media and game services.

Works with Claude Desktop, Cursor, VS Code Copilot, OpenClaw, and any other MCP-compatible client.

Demo

Features

Service	Tools
Sonarr	List series, search & add shows, upcoming episodes, download queue
Radarr	List movies, search & add movies, download queue
Lidarr	List artists, search & add artists/albums, queue, missing search
Prowlarr	List/test indexers, search releases, health check
qBittorrent	List/pause/resume/delete torrents, add magnets, transfer stats
SABnzbd	Queue, history, status, pause/resume, add NZB url, speed limit
RDTClient	Real-Debrid downloader: list/pause/resume/delete torrents, add magnets, provider status
Jellyfin	List libraries, recent additions, system info
RomM	System info, list platforms, list/search ROMs, game details
GameVault	List/search PC games, game details, random game, reindex library
Bookshelf	List/search authors & books, queue, missing, profiles, health

Only configure the services you use — unconfigured services are gracefully skipped.

Choose Your Services

To avoid flooding an MCP client's context with tools it does not need, the advertised tool catalog is configurable:

ENABLED_SERVICES=auto (default) advertises only services with a configured URL.
A comma-separated list such as sonarr,radarr,romm advertises exactly that subset.
ENABLED_SERVICES=all advertises every available tool.
Run python server.py --list-services to inspect configured/enabled services.
Run python server.py --setup for an interactive selector that prints the resulting ENABLED_SERVICES line.

Valid service names are sonarr, radarr, lidarr, prowlarr, qbittorrent, rdtclient, sabnzbd, jellyfin, romm, gamevault, and bookshelf. Aliases qbt, rdt, and sab are also accepted.

Quick Start

Option 1: Claude Desktop / Cursor / VS Code (stdio)

Install dependencies:
```
pip install "mcp[cli]>=1.9.0" httpx
```

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "arrstack": {
      "command": "python",
      "args": ["/path/to/arrstack-mcp/server.py"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-api-key",
        "QBT_URL": "http://localhost:8080",
        "QBT_USER": "admin",
        "QBT_PASS": "your-password",
        "JELLYFIN_URL": "http://localhost:8096"
      }
    }
  }
}

Restart your MCP client. Done!

Option 2: Docker (HTTP transport)

For remote setups or when running alongside your *arr stack:

git clone https://github.com/ct4nk3r/arrstack-mcp.git
cd arrstack-mcp
cp .env.example .env
# Edit .env with your service URLs and API keys
docker compose up -d

The server runs on port 8000 with Streamable HTTP transport.

Connect to OpenClaw

openclaw mcp set arrstack '{"url":"http://arrstack-mcp:8000/mcp","transport":"streamable-http"}'

Connect to other HTTP MCP clients

Point your client to http://<host>:8000/mcp using Streamable HTTP transport.

Option 3: Docker on the same network as your *arr stack

If your media services run in Docker, add arrstack-mcp to the same network:

services:
  arrstack-mcp:
    build: .
    container_name: arrstack-mcp
    ports:
      - "8000:8000"
    environment:
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-key
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-key
      - QBT_URL=http://qbittorrent:8080
      - QBT_USER=admin
      - QBT_PASS=your-password
      - JELLYFIN_URL=http://jellyfin:8096
    networks:
      - your-media-network

Configuration

All configuration is done via environment variables:

Variable	Required	Description
`ENABLED_SERVICES`	No	`auto` (default), `all`, or a comma-separated service subset
`SONARR_URL`	No	Sonarr base URL (e.g. `http://localhost:8989`)
`SONARR_API_KEY`	If Sonarr	Sonarr API key (Settings → General)
`RADARR_URL`	No	Radarr base URL (e.g. `http://localhost:7878`)
`RADARR_API_KEY`	If Radarr	Radarr API key (Settings → General)
`LIDARR_URL`	No	Lidarr base URL (e.g. `http://localhost:8686`)
`LIDARR_API_KEY`	If Lidarr	Lidarr API key (Settings → General)
`QBT_URL`	No	qBittorrent Web UI URL (e.g. `http://localhost:8080`)
`QBT_USER`	If qBt	qBittorrent username (default: `admin`)
`QBT_PASS`	If qBt	qBittorrent password
`RDT_URL`	No	RDTClient base URL (e.g. `http://localhost:6500`)
`RDT_USER`	If RDT login	RDTClient username (default: `admin`)
`RDT_PASS`	If RDT login	RDTClient password
`JELLYFIN_URL`	No	Jellyfin base URL (e.g. `http://localhost:8096`)
`JELLYFIN_API_KEY`	No	Jellyfin API key (optional, for authenticated endpoints)
`PROWLARR_URL`	No	Prowlarr base URL (e.g. `http://localhost:9696`)
`PROWLARR_API_KEY`	If Prowlarr	Prowlarr API key (Settings → General)
`ROMM_URL`	No	RomM base URL (e.g. `http://localhost:8081`)
`ROMM_API_TOKEN`	If RomM	RomM bearer token; alternatively use `ROMM_USER` and `ROMM_PASS`
`ROMM_USER`	If RomM basic auth	RomM username
`ROMM_PASS`	If RomM basic auth	RomM password
`GAMEVAULT_URL`	No	GameVault server URL (e.g. `http://localhost:8082`)
`GAMEVAULT_API_KEY`	If GameVault	GameVault API key
`MCP_ALLOWED_HOSTS`	For HTTP/SSE	Comma-separated accepted Host headers; supports wildcard ports such as `arrstack-mcp:*`
`LOG_LEVEL`	No	Request logging level (default: `INFO`; credentials are never logged)
`SAB_URL`	No	SABnzbd base URL (e.g. `http://localhost:8080`)
`SAB_API_KEY`	If SABnzbd	SABnzbd API key (Config → General → API Key)
`BOOKSHELF_URL`	No	Bookshelf base URL (e.g. `http://localhost:8787`)
`BOOKSHELF_API_KEY`	If Bookshelf	Bookshelf API key (Settings → General)

Available Tools

Sonarr (TV Shows)

Tool	Description
`sonarr_list_series`	List all series with episode counts and disk usage
`sonarr_get_series`	Get detailed info about a specific series
`sonarr_search`	Search for new shows to add
`sonarr_add_series`	Add a show by TVDB ID
`sonarr_upcoming`	Show upcoming episodes
`sonarr_queue`	Show current download queue

Radarr (Movies)

Tool	Description
`radarr_list_movies`	List all movies with download status
`radarr_get_movie`	Get detailed info about a specific movie
`radarr_search`	Search for new movies to add
`radarr_add_movie`	Add a movie by TMDB ID
`radarr_queue`	Show current download queue

Lidarr (Music)

Tool	Description
`lidarr_list_artists`	List all artists with album/track counts and disk usage
`lidarr_get_artist`	Get detailed info about a specific artist
`lidarr_search`	Search for artists to add
`lidarr_search_album`	Search for albums in metadata
`lidarr_add_artist`	Add an artist by name (requires quality + metadata profile + root folder)
`lidarr_list_quality_profiles`	List quality profiles
`lidarr_list_metadata_profiles`	List metadata profiles
`lidarr_list_root_folders`	List root folders with free space
`lidarr_queue`	Show current download queue
`lidarr_delete_queue_item`	Remove an item from the queue (optionally blocklist)
`lidarr_search_missing`	Trigger search for all missing albums

Prowlarr (Indexers)

Tool	Description
`prowlarr_list_indexers`	List all indexers with status
`prowlarr_test_indexer`	Test a specific indexer connection
`prowlarr_test_all_indexers`	Test all enabled indexers
`prowlarr_search`	Search across indexers for releases
`prowlarr_health`	Check system health warnings

qBittorrent (Downloads)

Tool	Description
`qbt_list_torrents`	List torrents with progress and speed
`qbt_torrent_details`	Get detailed torrent info
`qbt_add_magnet`	Add a magnet link
`qbt_pause`	Pause a torrent
`qbt_resume`	Resume a torrent
`qbt_delete`	Delete a torrent (optionally with files)
`qbt_transfer_info`	Global transfer statistics

SABnzbd (Usenet Downloads)

Tool	Description
`sab_queue`	Show the current download queue
`sab_history`	Show download history
`sab_status`	Show full server status (disk, speed, etc.)
`sab_pause`	Pause the entire queue
`sab_resume`	Resume the entire queue
`sab_pause_job`	Pause a specific queue item by NZO id
`sab_resume_job`	Resume a specific queue item by NZO id
`sab_delete_job`	Delete a queue item (optionally with files)
`sab_add_url`	Add an NZB by URL (with optional category/priority)
`sab_speed_limit`	Set the global speed limit (0..100% of configured max)

RDTClient (Real-Debrid Downloader)

RDTClient is a Real-Debrid / AllDebrid / Premiumize download manager that exposes a qBittorrent-compatible API, so it slots into Sonarr/Radarr just like qBt.

Tool	Description
`rdt_list_torrents`	List torrents with progress and speed
`rdt_torrent_details`	Get detailed torrent info
`rdt_add_magnet`	Add a magnet link to your debrid provider
`rdt_pause`	Pause one or more torrents
`rdt_resume`	Resume one or more torrents
`rdt_delete`	Delete one or more torrents (optionally with files)
`rdt_provider_status`	Show configured debrid provider (Real-Debrid / AllDebrid / etc.)

Jellyfin (Media Server)

Tool	Description
`jellyfin_libraries`	List media libraries
`jellyfin_recent`	Recently added items
`jellyfin_system_info`	Server version and system info

RomM (ROM Library)

Tool	Description
`romm_system_info`	Show version, detected platforms, and metadata sources
`romm_list_platforms`	List platforms, ROM counts, and library sizes
`romm_list_games`	List or search indexed ROMs
`romm_get_game`	Show details for one indexed ROM

GameVault (PC Game Library)

Tool	Description
`gamevault_list_games`	List or search PC games and installers
`gamevault_get_game`	Show details for one game
`gamevault_random_game`	Pick a random indexed game
`gamevault_reindex`	Scan the game-files directory for changes

Bookshelf (Books — Hardcover-flavored Readarr fork)

Bookshelf is pennydreadful/bookshelf, a fork of Readarr that uses hardcover.app as its metadata provider. It exposes the standard Readarr v1 API, so these tools behave like the Sonarr/Radarr/Lidarr equivalents.

Tool	Description
`bookshelf_health`	Version + active health-check issues
`bookshelf_list_authors`	List monitored authors with book counts and disk usage
`bookshelf_get_author`	Detailed info for an author by ID
`bookshelf_search_author`	Search Hardcover for an author
`bookshelf_search_book`	Search Hardcover for a book
`bookshelf_list_books`	List all tracked books
`bookshelf_queue`	Current download queue
`bookshelf_wanted_missing`	Books flagged as missing
`bookshelf_list_quality_profiles`	Quality profiles
`bookshelf_list_metadata_profiles`	Metadata profiles
`bookshelf_list_root_folders`	Root folders with free space
`bookshelf_search_missing`	Trigger a search for all missing books

Transport Options

# stdio (default) — for Claude Desktop, Cursor, VS Code
python server.py

# Streamable HTTP — for Docker / remote
python server.py --transport streamable-http --port 8000

# SSE — legacy HTTP transport
python server.py --transport sse --port 8000

Finding Your API Keys

Sonarr: Settings → General → API Key
Radarr: Settings → General → API Key
Lidarr: Settings → General → API Key
Prowlarr: Settings → General → API Key
qBittorrent: Settings → Web UI → Authentication
SABnzbd: Config → General → API Key
RDTClient: Settings → General → Authentication (or set Authentication: None to allow open access on a trusted network)
Jellyfin: Dashboard → API Keys → Add
RomM: User profile → API Tokens, or configure ROMM_USER and ROMM_PASS
GameVault: Admin panel → API Keys
Bookshelf: Settings → General → API Key (same as Readarr)

Security

The HTTP/SSE transports listen on 0.0.0.0:8000 by default, and MCP does not provide authentication by itself. Anyone who can reach that port can invoke tools using the configured service credentials.

Prefer stdio for same-machine clients.
For remote access, restrict port 8000 to Tailscale or place it behind an authenticated reverse proxy.
DNS-rebinding protection is enabled. Set MCP_ALLOWED_HOSTS to the exact hostnames or IP addresses clients use, with optional wildcard ports: localhost:*,127.0.0.1:*,arrstack-mcp:*,100.64.0.1:*.
The Docker image runs as non-root user appuser with UID 1000.
API keys and request headers are never logged.

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 16 Commits
screenshots		screenshots
tests		tests
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
mcp-config.example.json		mcp-config.example.json
requirements.txt		requirements.txt
server.py		server.py

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

🎬 arrstack-mcp

Demo

Features

Choose Your Services

Quick Start

Option 1: Claude Desktop / Cursor / VS Code (stdio)

Option 2: Docker (HTTP transport)

Connect to OpenClaw

Connect to other HTTP MCP clients

Option 3: Docker on the same network as your *arr stack

Configuration

Available Tools

Sonarr (TV Shows)

Radarr (Movies)

Lidarr (Music)

Prowlarr (Indexers)

qBittorrent (Downloads)

SABnzbd (Usenet Downloads)

RDTClient (Real-Debrid Downloader)

Jellyfin (Media Server)

RomM (ROM Library)

GameVault (PC Game Library)

Bookshelf (Books — Hardcover-flavored Readarr fork)

Transport Options

Finding Your API Keys

Security

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

🎬 arrstack-mcp

Demo

Features

Choose Your Services

Quick Start

Option 1: Claude Desktop / Cursor / VS Code (stdio)

Option 2: Docker (HTTP transport)

Connect to OpenClaw

Connect to other HTTP MCP clients

Option 3: Docker on the same network as your *arr stack

Configuration

Available Tools

Sonarr (TV Shows)

Radarr (Movies)

Lidarr (Music)

Prowlarr (Indexers)

qBittorrent (Downloads)

SABnzbd (Usenet Downloads)

RDTClient (Real-Debrid Downloader)

Jellyfin (Media Server)

RomM (ROM Library)

GameVault (PC Game Library)

Bookshelf (Books — Hardcover-flavored Readarr fork)

Transport Options

Finding Your API Keys

Security

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages