GPTDARR - Sonarr & Radarr MCP Server

@csmit195

About GPTDARR - Sonarr & Radarr MCP Server

A MCP Server for efficiently managing and automating TV shows and movies in Sonarr and Radarr setups. Simplify your media library management with AI-driven insights and commands.

#gptdarr #sonarr #radarr #media-management #automation

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gptdarr": {
      "command": "npx",
      "args": [
        "gptdarr",
        "setup"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is GPTDARR - Sonarr & Radarr MCP Server?

GPTDARR is an AI tool server using Model Context Protocol (MCP) that integrates with Sonarr and Radarr. It helps AI assistants search, add, and manage TV shows and movies in your media library.

How to use GPTDARR - Sonarr & Radarr MCP Server?

Ensure Node.js 18+, Sonarr/Radarr running, and an MCP-compatible chat client (e.g., 5ire, Claude). Run npx gptdarr setup and follow the interactive wizard to configure URLs, API keys, quality profiles, and root folders. After setup, copy the generated NPX command and paste it into your chat client’s New Command tool. Finally, load the provided system prompt from llm_system_prompt.txt to guide the AI assistant.

Key features of GPTDARR - Sonarr & Radarr MCP Server

Search for TV shows and movies across Sonarr and Radarr
Add TV series to Sonarr
Add movies to Radarr
Comprehensive logging for debugging and monitoring

Use cases of GPTDARR - Sonarr & Radarr MCP Server

Search for media content and view results
Add TV series to your Sonarr library
Add movies to your Radarr library
Manage media additions through natural language prompts

FAQ from GPTDARR - Sonarr & Radarr MCP Server

What are the prerequisites?

Node.js 18 or higher, an active Sonarr and Radarr setup, and an MCP-compatible chat client (e.g., 5ire, Claude).

Does the server handle TV shows as well as movies?

Yes, but it works best with movies; TV show support is more limited. Individual season and episode file checks are not yet supported.

Where are logs stored?

Logs are stored in your home directory in a .gptdarr folder.

What tools does the server provide?

The tools are lookup-content (search by title/year), add-series (add series to Sonarr), and add-movies (add movies to Radarr).

Is there a system prompt I should use?

Yes, after setup you must load the content of llm_system_prompt.txt into your chat client. It contains essential instructions for proper interaction with Radarr and Sonarr.

Frequently asked questions