mcp-arr

Overview

This MCP server provides a unified interface to manage all *arr applications from a single location. It supports both local stdio mode for Claude/Codex-style clients and remote HTTP mode for hosted MCP clients like ChatGPT. The server offers comprehensive functionality across all *arr services, including library management, search capabilities, download monitoring, calendar integration, and configuration review. It also includes tools for TRaSH Guides reference, allowing users to compare their quality profiles and naming conventions against community recommendations.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• arr_status

  Get connection status for all configured *arr services

  Try:Check status of all my *arr servicesTry:Are all services running?
• arr_search_all

  Search across all configured services simultaneously

  Try:Search for comedy across all servicesTry:Find sci-fi in my libraries
• sonarr_get_series

  List all TV series in your Sonarr library

  Try:Show me all my TV seriesTry:List all shows in my library
• sonarr_search

  Search for TV series by name

  Try:Search for sci-fi showsTry:Find 'Breaking Bad' TV show
• sonarr_add_series

  Add a TV series to Sonarr (supports tags)

  Try:Add 'The Expanse' to my TV libraryTry:Add this show with '4k' tag
• sonarr_get_queue

  View current Sonarr download queue

  Try:What's downloading in Sonarr?Try:Check TV download progress
• radarr_get_movies

  List all movies in your Radarr library

  Try:Show me all my moviesTry:List films in my collection
• radarr_search

  Search for movies by name

  Try:Search for action moviesTry:Find 'Dune' movie
• radarr_add_movie

  Add a movie to Radarr (supports tags)

  Try:Add this movie to my libraryTry:Add 'Inception' with '4k' tag
• lidarr_get_artists

  List all artists in your Lidarr library

  Try:Show me all my music artistsTry:List musicians in my collection
• prowlarr_get_indexers

  List all configured Prowlarr indexers

  Try:Show my indexersTry:List all configured trackers
• sonarr_review_setup

  Comprehensive Sonarr configuration dump for AI analysis

  Try:Review my Sonarr setup and suggest improvementsTry:Analyze my TV configuration

Comparable tools

Installation

npx mcp-arr-server

MCP_TRANSPORT=http PORT=3000 npx mcp-arr-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"
      }
    }
  }
}

FAQ

Which *arr applications are supported?

The server supports all major *arr applications: Sonarr (TV series), Radarr (movies), Lidarr (music), and Prowlarr (indexer management). You can configure any combination of these services based on what you have installed.

Can I use this with ChatGPT?

Yes, the server supports remote HTTP mode which is compatible with ChatGPT's MCP connectors. Run the server with 'MCP_TRANSPORT=http' and connect ChatGPT to the '/mcp' endpoint. It also provides generic 'search' and 'fetch' tools expected by ChatGPT-style clients.

Compare mcp-arr with