felipemeres/radarr-mcp

Radarr MCP Server

A simplified MCP (Model Context Protocol) server for interacting with the Radarr API. This server provides tools for searching movies in your library, searching for new movies, and adding movies to your library.

Features

• Search User Library: Search for movies currently in your Radarr library
• Search New Movies: Search for movies not in your library using external sources
• Add Movie to Library: Add movies to your Radarr library with customizable options

Installation

1. Install dependencies:

pip install -r requirements.txt

2. Create a .env file with your Radarr configuration:

RADARR_URL=http://your-radarr-server:7878
RADARR_API_KEY=your_api_key_here

Usage

Standalone Testing

python3 radarr-mcp-simple.py

With Claude Code

Add to your .claude.json MCP servers configuration:

{
  "mcpServers": {
    "radarr": {
      "type": "stdio",
      "command": "python3",
      "args": ["/path/to/radarr-mcp/radarr-mcp-simple.py"],
      "env": {}
    }
  }
}

Tools

search_user_library

Search for movies in your Radarr library.

• query (string): Movie title, IMDb ID, or TMDb ID

search_new_movies

Search for movies not in your library (external search).

• query (string): Movie title, IMDb ID, or TMDb ID

add_movie_to_library

Add a movie to your Radarr library.

• tmdb_id (integer): TMDb ID of the movie
• title (string): Movie title
• year (integer): Release year
• root_folder_path (string): Path for storing the movie
• quality_profile_id (integer, optional): Quality profile (default: 6)
• monitored (boolean, optional): Monitor for releases (default: true)
• search_for_movie (boolean, optional): Search immediately (default: true)

Dependencies

• httpx >= 0.25.0
• python-dotenv >= 1.0.0

Environment Variables

• RADARR_URL: URL to your Radarr instance (default: http://localhost:7878)
• RADARR_API_KEY: Your Radarr API key (required)

License

This project is open source and available under the MIT License.