What can you do with this server?

The servarr-mcp server provides a Model Context Protocol (MCP) interface to manage the Servarr media stack (Sonarr, Radarr, Lidarr, Readarr, Prowlarr). Key capabilities include: * Browse & search content – List and get details for TV series, movies, artists/albums, and authors/books tracked by each app; search for new content to add. * Add & edit media – Add new series/movies/artists/authors with desired quality profile, root folder, and monitor settings; edit existing entries (monitor state, tags, quality profile, root folder). * Calendar – View upcoming TV episodes (Sonarr) and movie releases (Radarr). * Download queue management – View, remove (with blocklist/client-delete control), or re-grab items in the queue across all apps. * History – Review recent download, import, and failure events across all apps; mark failed entries to trigger re-searches. * Wanted & searches – List missing/below-cutoff episodes; trigger searches for missing episodes, by series, season, or specific episode IDs. * Release discovery – Live-search enabled indexers for specific releases and manually grab a chosen one. * Metadata refresh – Trigger metadata re-pulls (e.g., cast, episode lists, artwork) for a series. * System health & config – Check health warnings, disk space, root folders, quality profiles, and tags. * Prowlarr indexer management – List indexers and their stats, search across all enabled indexers, view query/grab history. * Async command monitoring – Poll the status of long-running background operations like searches or refreshes.

Which integrations are available for this server?

Provides tools for managing movies: list movies, get details, search for new movies, view calendar, download queue, and history. Provides tools for managing TV series: list series, get details, search for new series, list episodes, view calendar, download queue, and history.

How do I use servarr-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@servarr-mcp show me the current download queue" 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.

de en es ja ko ru zh

servarr-mcp

by CarlDog

Overview Schema Related Servers Score Discussions

TypeScript

Remote

servarr-mcp

code confidence · claude-opus-4-8[1m] · 2026-07-07 · details

An MCP server for the Servarr stack — Sonarr, Radarr, Lidarr, Readarr, and Prowlarr — packaged as a Docker container. Lets an MCP client (Claude Desktop, etc.) browse, search, and manage whichever *arr apps you're running: library reads plus add/edit, queue management, interactive release grabbing, and search/refresh commands. Every tool carries MCP annotations (readOnlyHint, destructiveHint, idempotentHint) so clients can distinguish and gate the write surface.

Apps are optional: configure only the ones you actually run, and only those tools register.

Tools

Sonarr (TV)

Read:

Tool	Description
`sonarr_list_series`	List all TV series tracked by Sonarr
`sonarr_get_series`	Series details by ID
`sonarr_lookup_series`	Search TVDB for a new series to add
`sonarr_list_episodes`	List episodes for a series
`sonarr_get_episode`	Episode details by ID
`sonarr_calendar`	Upcoming episodes
`sonarr_queue`	Current download queue
`sonarr_history`	Recent history (newest first)
`sonarr_history_series`	History for one series
`sonarr_wanted_missing`	Monitored episodes with no file
`sonarr_wanted_cutoff`	Episodes below their quality cutoff
`sonarr_release_search`	Live indexer search for candidate releases
`sonarr_get_command`	Poll an async command's status
`sonarr_health`	Health check results
`sonarr_diskspace`	Disk space per root folder
`sonarr_list_quality_profiles`	Quality profiles
`sonarr_list_root_folders`	Root folders
`sonarr_list_tags`	Tags

Write:

Tool	Description
`sonarr_add_series`	Add a series to the library
`sonarr_edit_series`	Edit a tracked series (monitoring, profile, etc.)
`sonarr_grab_release`	Grab a release from `sonarr_release_search` results
`sonarr_queue_remove`	Remove a queue item (optionally blocklist / delete from client)
`sonarr_queue_regrab`	Force re-grab of a stuck queue item
`sonarr_history_mark_failed`	Mark a history record failed (triggers re-search)
`sonarr_search_missing`	Trigger a search for missing episodes
`sonarr_search_series`	Trigger a search for a whole series
`sonarr_search_season`	Trigger a search for one season
`sonarr_search_episode`	Trigger a search for specific episodes
`sonarr_refresh_series`	Refresh series metadata and rescan disk

Radarr (movies)

Read:

Tool	Description
`radarr_list_movies`	All movies tracked by Radarr
`radarr_get_movie`	Movie details by ID
`radarr_lookup_movie`	Search TMDB for a new movie to add
`radarr_lookup_tmdb`	Look up a movie by TMDB ID
`radarr_lookup_imdb`	Look up a movie by IMDb ID
`radarr_calendar`	Upcoming movie releases
`radarr_queue`	Current download queue
`radarr_history`	Recent history (newest first)
`radarr_history_movie`	History for one movie
`radarr_wanted_missing`	Monitored movies with no file
`radarr_wanted_cutoff`	Movies below their quality cutoff
`radarr_release_search`	Live indexer search for candidate releases
`radarr_get_command`	Poll an async command's status
`radarr_health`	Health check results
`radarr_diskspace`	Disk space per root folder
`radarr_list_quality_profiles`	Quality profiles
`radarr_list_root_folders`	Root folders
`radarr_list_tags`	Tags

Write:

Tool	Description
`radarr_add_movie`	Add a movie to the library
`radarr_edit_movie`	Edit a tracked movie (monitoring, profile, etc.)
`radarr_grab_release`	Grab a release from `radarr_release_search` results
`radarr_queue_remove`	Remove a queue item (optionally blocklist / delete from client)
`radarr_queue_regrab`	Force re-grab of a stuck queue item
`radarr_history_mark_failed`	Mark a history record failed (triggers re-search)
`radarr_search_missing`	Trigger a search for missing movies
`radarr_search_movie`	Trigger a search for specific movies
`radarr_refresh_movie`	Refresh movie metadata and rescan disk

Lidarr (music)

Read:

Tool	Description
`lidarr_list_artists`	All artists tracked by Lidarr
`lidarr_get_artist`	Artist details by ID
`lidarr_lookup_artist`	Search for a new artist to add
`lidarr_list_albums`	List albums (optionally per-artist)
`lidarr_get_album`	Album details by ID
`lidarr_get_track`	Track details
`lidarr_list_trackfiles`	Track files on disk
`lidarr_queue`	Current download queue
`lidarr_history`	Recent history
`lidarr_history_artist`	History for one artist
`lidarr_wanted_missing`	Monitored albums with no files
`lidarr_wanted_cutoff`	Albums below their quality cutoff
`lidarr_release_search`	Live indexer search for candidate releases
`lidarr_get_command`	Poll an async command's status
`lidarr_health`	Health check results
`lidarr_diskspace`	Disk space per root folder
`lidarr_list_quality_profiles`	Quality profiles
`lidarr_list_metadata_profiles`	Metadata profiles
`lidarr_list_root_folders`	Root folders
`lidarr_list_tags`	Tags

Write:

Tool	Description
`lidarr_add_artist`	Add an artist to the library
`lidarr_edit_artist`	Edit a tracked artist (monitoring, profiles, etc.)
`lidarr_grab_release`	Grab a release from `lidarr_release_search` results
`lidarr_queue_remove`	Remove a queue item (optionally blocklist / delete from client)
`lidarr_queue_regrab`	Force re-grab of a stuck queue item
`lidarr_history_mark_failed`	Mark a history record failed (triggers re-search)
`lidarr_search_missing`	Trigger a search for missing albums
`lidarr_search_artist`	Trigger a search for an artist's albums
`lidarr_search_album`	Trigger a search for specific albums
`lidarr_refresh_artist`	Refresh artist metadata and rescan disk

Readarr (books)

Read:

Tool	Description
`readarr_list_authors`	All authors tracked by Readarr
`readarr_get_author`	Author details by ID
`readarr_lookup_author`	Search for a new author to add
`readarr_list_books`	List books (optionally per-author)
`readarr_get_book`	Book details by ID
`readarr_queue`	Current download queue
`readarr_history`	Recent history
`readarr_history_author`	History for one author
`readarr_wanted_missing`	Monitored books with no files
`readarr_wanted_cutoff`	Books below their quality cutoff
`readarr_release_search`	Live indexer search for candidate releases
`readarr_get_command`	Poll an async command's status
`readarr_health`	Health check results
`readarr_diskspace`	Disk space per root folder
`readarr_list_quality_profiles`	Quality profiles
`readarr_list_metadata_profiles`	Metadata profiles
`readarr_list_root_folders`	Root folders
`readarr_list_tags`	Tags

Write:

Tool	Description
`readarr_add_author`	Add an author to the library
`readarr_edit_author`	Edit a tracked author (monitoring, profiles, etc.)
`readarr_grab_release`	Grab a release from `readarr_release_search` results
`readarr_queue_remove`	Remove a queue item (optionally blocklist / delete from client)
`readarr_queue_regrab`	Force re-grab of a stuck queue item
`readarr_history_mark_failed`	Mark a history record failed (triggers re-search)
`readarr_search_missing`	Trigger a search for missing books
`readarr_search_author`	Trigger a search for an author's books
`readarr_search_book`	Trigger a search for specific books
`readarr_refresh_author`	Refresh author metadata and rescan disk

Prowlarr (indexer manager)

Read-only:

Tool	Description
`prowlarr_list_indexers`	All configured indexers
`prowlarr_indexer_stats`	Per-indexer query/grab stats
`prowlarr_indexer_status`	Indexer health / disabled status
`prowlarr_search`	Search across enabled indexers
`prowlarr_history`	Recent history (queries, grabs)
`prowlarr_health`	Health check results

Related MCP server: nas-mcp-server

Configuration

Each app uses two environment variables. Set both for an app to enable its tools; leave them unset to skip the app entirely.

App	URL var	API key var	Default port
Sonarr	`SONARR_URL`	`SONARR_API_KEY`	8989
Radarr	`RADARR_URL`	`RADARR_API_KEY`	7878
Lidarr	`LIDARR_URL`	`LIDARR_API_KEY`	8686
Readarr	`READARR_URL`	`READARR_API_KEY`	8787
Prowlarr	`PROWLARR_URL`	`PROWLARR_API_KEY`	9696

API keys are found under each app's Settings → General → API Key.

At least one app must be configured or the server exits with an error.

Same-host deployments

When the *arr apps run on the same Docker host as this container (typical home-lab setup), don't use the host's hostname (e.g. my-nas) in the *_URL vars — Docker's DNS context can't resolve the host's own name from inside a container. Use http://host.docker.internal:<port> instead. The provided docker-compose.yml already maps host.docker.internal to the host gateway via extra_hosts, so this works on Linux Docker too (not just Docker Desktop).

Run with Docker

docker build -t servarr-mcp .
docker run -i --rm \
  -e SONARR_URL=http://192.168.1.50:8989 -e SONARR_API_KEY=... \
  -e RADARR_URL=http://192.168.1.50:7878 -e RADARR_API_KEY=... \
  -e PROWLARR_URL=http://192.168.1.50:9696 -e PROWLARR_API_KEY=... \
  servarr-mcp

Published image

After each push to main, GitHub Actions builds and pushes a multi-arch image to GHCR:

ghcr.io/carldog/servarr-mcp:latest (linux/amd64 + linux/arm64)

Pull instead of building locally:

docker pull ghcr.io/carldog/servarr-mcp:latest
docker run -i --rm \
  -e SONARR_URL=... -e SONARR_API_KEY=... \
  ghcr.io/carldog/servarr-mcp:latest

Run with Docker Compose (HTTP, long-lived)

The compose file runs the server in HTTP mode (Streamable HTTP) for long-lived deployment via Portainer or Compose. It pulls the published image from ghcr.io/carldog/servarr-mcp:latest.

# Set whichever app credentials apply:
export SONARR_URL=http://192.168.1.50:8989; export SONARR_API_KEY=...
export RADARR_URL=http://192.168.1.50:7878; export RADARR_API_KEY=...
# ... (other apps as needed)
export HOST_PORT=3002  # optional, defaults to 3002

docker compose up

The MCP endpoint will be at http://<host>:${HOST_PORT}/mcp.

Deploy via Portainer (Stack from Git)

In Portainer, Stacks → Add Stack → Repository.
Repository URL: https://github.com/CarlDog/servarr-mcp
Compose path: docker-compose.yml
Environment variables: set whichever <APP>_URL/<APP>_API_KEY pairs apply, plus optionally HOST_PORT.
Deploy. Healthcheck reaches green within ~10 seconds.

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "servarr": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SONARR_URL", "-e", "SONARR_API_KEY",
        "-e", "RADARR_URL", "-e", "RADARR_API_KEY",
        "-e", "PROWLARR_URL", "-e", "PROWLARR_API_KEY",
        "servarr-mcp"
      ],
      "env": {
        "SONARR_URL": "http://192.168.1.50:8989",
        "SONARR_API_KEY": "...",
        "RADARR_URL": "http://192.168.1.50:7878",
        "RADARR_API_KEY": "...",
        "PROWLARR_URL": "http://192.168.1.50:9696",
        "PROWLARR_API_KEY": "..."
      }
    }
  }
}

Repeat the -e and env block patterns for whichever apps you run.

Local development

npm install
cp .env.example .env  # then edit
SONARR_URL=... SONARR_API_KEY=... npm run dev

Security

The container runs as a non-root user (servarr).
API keys are passed via env vars — never bake them into the image.
A .githooks/pre-commit runs gitleaks on every commit. Activate it once per clone: git config core.hooksPath .githooks.

Install Server

license - not found

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

<1hResponse time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/CarlDog/servarr-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server