Skip to content
appsgit

MCP Arr

MCP Arr is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for *arr media suite - Sonarr, Radarr, Lidarr, Readarr, Prowlarr. It has 222 GitHub stars, is released under the MIT license and runs locally with npx -y mcp-arr-server.

github.com/aplaceforallmystuff/mcp-arr (opens in a new tab)

  • Needs API key
  • Other
  • MIT
  • Actively maintained

Install MCP Arr

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "mcp-arr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-arr-server"
      ],
      "env": {
        "SONARR_API_KEY": "your-value",
        "RADARR_API_KEY": "your-value",
        "LIDARR_API_KEY": "your-value",
        "READARR_API_KEY": "your-value",
        "PROWLARR_API_KEY": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env SONARR_API_KEY=your-value --env RADARR_API_KEY=your-value --env LIDARR_API_KEY=your-value --env READARR_API_KEY=your-value --env PROWLARR_API_KEY=your-value --transport stdio mcp-arr -- npx -y mcp-arr-server

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "mcp-arr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-arr-server"
      ],
      "env": {
        "SONARR_API_KEY": "your-value",
        "RADARR_API_KEY": "your-value",
        "LIDARR_API_KEY": "your-value",
        "READARR_API_KEY": "your-value",
        "PROWLARR_API_KEY": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "sonarr_api_key",
      "description": "SONARR_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "radarr_api_key",
      "description": "RADARR_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "lidarr_api_key",
      "description": "LIDARR_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "readarr_api_key",
      "description": "READARR_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "prowlarr_api_key",
      "description": "PROWLARR_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "mcp-arr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-arr-server"
      ],
      "env": {
        "SONARR_API_KEY": "${input:sonarr_api_key}",
        "RADARR_API_KEY": "${input:radarr_api_key}",
        "LIDARR_API_KEY": "${input:lidarr_api_key}",
        "READARR_API_KEY": "${input:readarr_api_key}",
        "PROWLARR_API_KEY": "${input:prowlarr_api_key}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
SONARR_URLNoSonarr server URL
SONARR_API_KEYsecretNoSonarr API key
RADARR_URLNoRadarr server URL
RADARR_API_KEYsecretNoRadarr API key
LIDARR_URLNoLidarr server URL
LIDARR_API_KEYsecretNoLidarr API key
READARR_URLNoReadarr server URL
READARR_API_KEYsecretNoReadarr API key
PROWLARR_URLNoProwlarr server URL
PROWLARR_API_KEYsecretNoProwlarr API key

Tools (40)

Parsed from the Tools section of the README; check the repository for the current list.

  • 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)

  • sonarr_refresh_series

    Trigger a metadata refresh for a specific series in Sonarr

  • radarr_get_movies

    List all movies in your library

  • radarr_search

    Search for movies by name (returns tmdbId for adding)

  • radarr_add_movie

    Add a movie to Radarr (supports tags)

  • radarr_get_root_folders

    Get available root folders for adding movies

  • radarr_get_quality_profiles

    Get available quality profiles for adding movies

  • radarr_get_queue

    View current download queue with limit and offset pagination

  • radarr_get_calendar

    See upcoming releases

  • radarr_search_movie

    Trigger search to download a movie in your library

  • radarr_search_movies

    Bulk-trigger searches for multiple movie IDs at once

  • radarr_update_movie

    Update a movie's quality profile, monitored status, minimum availability, tags, or path

  • radarr_delete_queue_item

    Remove an item from the download queue (optionally blocklist the release)

  • radarr_refresh_movie

    Trigger a metadata refresh for a specific movie in Radarr

  • lidarr_get_artists

    List all artists in your library

  • lidarr_search

    Search for artists by name (returns foreignArtistId for adding)

  • lidarr_add_artist

    Add an artist to Lidarr (supports tags)

  • lidarr_get_root_folders

    Get available root folders for adding artists

  • lidarr_get_quality_profiles

    Get available quality profiles for adding artists

  • lidarr_get_metadata_profiles

    Get available metadata profiles for adding artists

  • lidarr_get_queue

    View current download queue with limit and offset pagination

  • lidarr_get_albums

    List albums for an artist (shows missing vs available)

  • lidarr_search_album

    Trigger search for a specific album

  • lidarr_search_missing

    Trigger search for all missing albums for an artist

  • lidarr_get_calendar

    See upcoming album releases

  • prowlarr_get_indexers

    List all configured indexers

  • prowlarr_search

    Search across all indexers

About MCP Arr

MCP server for the *arr media management suite - Sonarr, Radarr, Lidarr, and Prowlarr. Supports both local stdio mode for Claude/Codex-style clients and remote HTTP mode for hosted MCP clients such as ChatGPT connectors.

  • claude
  • home-automation
  • mcp
  • mcp-server
  • media-management
  • model-context-protocol
  • radarr
  • sonarr

FAQ

MCP Arr FAQ

Still curious? Email info@appsgit.com.

What is MCP Arr?

MCP Arr is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for *arr media suite - Sonarr, Radarr, Lidarr, Readarr, Prowlarr. It has 222 GitHub stars, is released under the MIT license and runs locally with npx -y mcp-arr-server. The source code is at github.com/aplaceforallmystuff/mcp-arr.

How do I install the MCP Arr MCP server?

Add the command npx -y mcp-arr-server to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is MCP Arr free?

The server is open source under the MIT license, so running it is free. It needs credentials (SONARR_API_KEY, RADARR_API_KEY, LIDARR_API_KEY, READARR_API_KEY and PROWLARR_API_KEY) for the service it connects to, which may require a paid account.

Is MCP Arr actively maintained?

The most recent commit was on Aug 9, 2026. The latest release is v1.7.3, published Jul 29, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.