GPTDARR - Sonarr & Radarr MCP Server

by csmit195

3 stars

425 downloads

Not rated

GitHub

About

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.

Details

Author: csmit195
GitHub stars: 3
Downloads: 425
Categories: Other, Automation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name GPTDARR - Sonarr & Radarr MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "gptdarr - sonarr & radarr mcp server": {
            "gptdarr": {
                "command": "npx",
                "args": [
                    "gptdarr",
                    "setup"
                ]
            }
        }
    }
}

McpServers

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

GPTDARR - Sonarr & Radarr MCP Server

Description

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.

Features

- Search for TV shows and movies across Sonarr and Radarr - Add TV series to Sonarr - Add movies to Radarr - Comprehensive logging system for debugging and monitoring (sorry about the litter, this is very much a work in progress application)

Current Limitations

- Works best with movies; TV show support is more limited - Does not support individual season and episode file checks - Monitoring toggles are not implemented (unmonitored items are ignored) - Prone to hallucinating tool-usage, make sure it runs the tool.

Todo

- [ ] Implement individual season and episode file checks - [ ] Add support for toggling monitoring status - [ ] Improve TV show support to match movie functionality - [ ] Override quality profile through natural language - [ ] Improve tool naming and descriptions so the LLM doesn't hallucinate tool calls (looking for expert advice here) - [ ] Improve LLM system prompt to reduce hallucinations (looking for expert advice here too)

Getting Started

Prerequisites

- Node.js 18 or higher - Sonarr and Radarr set up and running - An MCP-compatible chat client (e.g., 5ire, Claude)

Installation & Setup

1. Run the interactive configuration wizard:

   npx gptdarr setup

2. The wizard will guide you through setting up:
- Sonarr URL and API key
- Radarr URL and API key
- Quality profiles for both services
- Root folders for media storage
- Logging preferences

3. After completing the setup, the wizard will generate an NPX command (recommended). Copy this command.

4. In your MCP-compatible chat client (e.g., 5ire):
- Go to Tools > New > Command
- Paste the copied command
- The chat client will now be able to start and communicate with the GPTDarr MCP server

5. Important: System Prompt
- After setting up the tool, make sure to use the provided system prompt located in llm_system_prompt.txt
- This prompt contains essential instructions for the AI assistant to properly interact with Radarr and Sonarr
- The prompt ensures consistent handling of movie and TV show requests, proper status reporting, and efficient content management

The server provides the following tools:
- lookup-content: Search for TV shows and movies
- Parameters:
- title: The title to search for
- year (optional): Release year to refine search

- add-series: Add TV series to Sonarr
- Parameters:
- items: List of TV series to add, each with:
- seriesName: Name of the TV series
- seriesYear (optional): Year of the TV series

- add-movies: Add movies to Radarr
- Parameters:
- items: List of movies to add, each with:
- title: Title of the movie
- year (optional): Year of the movie

Logging

The logs are mostly for development, and we suggest disabling them when running setup. - Content lookups - Series and movie additions - API requests and responses - Errors and exceptions

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

Contributing

Contributions are welcome! Please read our Contributing Guide for more information.

License

This project is licensed under the MIT License.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

GPTDARR - Sonarr & Radarr MCP Server

Description

Features

Current Limitations

Todo

Getting Started

Prerequisites

Installation & Setup

Logging

Contributing

License

Install

More like this

@mendableai/firecrawl Mcp Server

Umut Naci

Playwright

Sequential Thinking

Filesystem

EverArt