How do I install the mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `SONARR_URL`, `SONARR_API_KEY`, `RADARR_URL`, `RADARR_API_KEY`, `LIDARR_URL`, `LIDARR_API_KEY`, `PROWLARR_URL`, `PROWLARR_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

MCP Server — aplaceforallmystuff/mcp-arr

MCP server for *arr media suite - Sonarr, Radarr, Lidarr, Readarr, Prowlarr

Remote serverstreamable-httpTypeScript

What is the MCP Server?

MCP server for arr media suite - Sonarr, Radarr, Lidarr, Readarr, Prowlarr

What you get

Unified media management — - Control all your *arr applications from one interface
Natural language queries — - Ask about your library in plain English
Cross-service search — - Find content across TV, movies, and music simultaneously
Download monitoring — - Check queue status and progress across all services
Calendar integration — - See upcoming releases for all media types
Configuration review — - Get AI-powered suggestions for optimizing your setup

Configuration and credentials

Node.js 18+ - At least one *arr application running with API access: - Sonarr for TV series - Radarr for movies - Lidarr for music - Prowlarr for indexer management

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
arr_status	Get connection status for all configured *arr services
arr_search_all	Search across all configured services simultaneously
search	Generic discovery tool for remote MCP clients such as ChatGPT
fetch	Generic detail-fetch tool for items returned by search
sonarr_get_series	List all TV series in your library
sonarr_search	Search for TV series by name (returns tvdbId for adding)
sonarr_add_series	Add a TV series to Sonarr (supports tags)
sonarr_get_root_folders	Get available root folders for adding series
sonarr_get_quality_profiles	Get available quality profiles for adding series
sonarr_get_queue	View current download queue with limit and offset pagination
sonarr_get_calendar	See upcoming episodes
sonarr_get_episodes	List episodes for a series (shows missing vs available)
sonarr_search_missing	Trigger search for all missing episodes in a series
sonarr_search_episode	Trigger search for specific episode(s)

How to install the MCP Server

{
  "mcpServers": {
    "arr": {
      "command": "npx",
      "args": ["-y", "mcp-arr-server"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-sonarr-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-radarr-api-key",
        "LIDARR_URL": "http://localhost:8686",
        "LIDARR_API_KEY": "your-lidarr-api-key",
        "PROWLARR_URL": "http://localhost:9696",
        "PROWLARR_API_KEY": "your-prowlarr-api-key"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Node.js 18+ - At least one *arr application running with API access: - Sonarr for TV series - Radarr for movies - Lidarr for music - Prowlarr for indexer management

Variable	Description	Required
SONARR_URL	Endpoint or connection string the server talks to.	Yes
SONARR_API_KEY	Credential the server authenticates with.	Yes
RADARR_URL	Endpoint or connection string the server talks to.	Yes
RADARR_API_KEY	Credential the server authenticates with.	Yes
LIDARR_URL	Endpoint or connection string the server talks to.	Yes
LIDARR_API_KEY	Credential the server authenticates with.	Yes
PROWLARR_URL	Endpoint or connection string the server talks to.	Yes
PROWLARR_API_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use MCP to arr status.”
“Use MCP to arr search all.”
“Use MCP to search.”

Frequently asked questions

MCP server for *arr media suite - Sonarr, Radarr, Lidarr, Readarr, Prowlarr Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.