Skip to main content
Glama

Sonarr MCP Server

by MichaelReubenDev
GitHub
Python
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Sonarr MCP Server

A Model Context Protocol (MCP) server for Sonarr, enabling AI assistants to manage your TV series collection through natural language interactions.

Features

  • 🔍 Search Series - Find TV series to add to your collection
  • ➕ Add Series - Add TV series with quality profiles, season monitoring, and search options
  • 📋 List Series - View your entire TV series library with episode counts
  • 📺 Series Details - Get detailed information including episode status and downloads
  • ⚙️ Update Series - Change quality profiles, season monitoring, and trigger searches
  • 🗑️ Delete Series/Seasons - Remove entire series or specific seasons (with optional file deletion)
  • 🔍 Interactive Search - Browse available releases for episodes with quality and seeder info
  • 📊 Quality Profiles - View available quality settings
  • ⬇️ Download Release - Manually download specific releases for episodes
  • 🎯 Season Control - Granular monitoring and management of individual seasons

Installation

pip install sonarr-mcp

From Source

git clone https://github.com/MichaelReubenDev/sonarr-mcp.git cd sonarr-mcp uv sync

Usage

Command Line

# Using uvx (if installed from PyPI) uvx sonarr-mcp --url http://localhost:8989 --api-token YOUR_API_TOKEN # Using uv run (from source) uv run sonarr-mcp --url http://localhost:8989 --api-token YOUR_API_TOKEN # With debug logging uv run sonarr-mcp --url http://localhost:8989 --api-token YOUR_API_TOKEN --debug

With Claude Desktop

Add this to your Claude Desktop MCP configuration:

{ "mcpServers": { "sonarr": { "command": "uvx", "args": [ "sonarr-mcp", "--url", "http://localhost:8989", "--api-token", "YOUR_API_TOKEN" ] } } }

With MCP Inspector

For testing and development:

npx @modelcontextprotocol/inspector uv run sonarr-mcp --url http://localhost:8989 --api-token YOUR_API_TOKEN

Configuration

Required Parameters

  • --url: Your Sonarr base URL (e.g., http://localhost:8989)
  • --api-token: Your Sonarr API token (found in Settings → General → Security)

Optional Parameters

  • --debug: Enable debug logging

Available Tools

ToolDescriptionParameters
search_seriesSearch for TV series to addquery (string)
add_seriesAdd a TV series to Sonarrtvdb_id (int), quality_profile_id (int), monitor_type (string, required), root_folder_path (string, default: "/tv"), season_folder (bool, default: true), monitor_seasons (array, optional), search_for_missing_episodes (bool, default: false)
list_seriesList all TV series in libraryNone
get_seriesGet detailed series informationseries_id (int)
update_seriesUpdate series settingsseries_id (int), quality_profile_id (int, optional), monitor_type (string, optional), monitor_seasons (array, optional), start_search (bool, default: false)
delete_seriesDelete a series or specific seasonsseries_id (int), delete_seasons (array, optional), delete_files (bool, default: false)
interactive_searchBrowse available releasesseries_id (int), season_number (int, optional), episode_number (int, optional)
download_releaseDownload a specific releaserelease_guid (string), series_id (int)
get_quality_profilesList available quality profilesNone

Monitor Types

The monitor_type parameter supports these options:

  • all - Monitor all episodes
  • future - Monitor future episodes only
  • missing - Monitor missing episodes
  • existing - Monitor existing episodes
  • recent - Monitor recent episodes
  • first - Monitor first season only
  • latest - Monitor latest season only
  • none - Monitor no episodes
  • season_specific - Monitor specific seasons (requires monitor_seasons array)

Example Workflows

Adding a TV Series

  1. Search for series: "Search for Breaking Bad TV series"
  2. Add series: "Add Breaking Bad with HD-1080p quality, monitor all episodes"
  3. Add with specific seasons: "Add The Office with monitor_type: 'season_specific' and monitor_seasons: [1, 2, 3]"
  4. Check status: "Show me details for Breaking Bad"

Managing Your Collection

  1. List series: "Show me all my TV series"
  2. Update monitoring: "Change series ID 123 to monitor only seasons 2 and 4"
  3. Update quality and search: "Change series ID 123 to 4K quality and start searching for missing episodes"
  4. Browse releases: "Show me available releases for series ID 123 season 2"

Season-Specific Management

  1. Monitor specific seasons: "Update series ID 123 with monitor_type: 'season_specific', monitor_seasons: [1, 3, 5]"
  2. Delete specific seasons: "Delete seasons 2 and 4 from series ID 123 including files"
  3. Search specific episodes: "Show releases for series ID 123 season 3 episode 5"

Finding Downloads

  1. Get series details: "Show me the status of Game of Thrones"
  2. Interactive search: "What releases are available for The Walking Dead season 1?"
  3. Episode search: "Find releases for series ID 456 season 2 episode 10"

Requirements

  • Python 3.13+
  • Sonarr v3+ with API access
  • Network access to your Sonarr instance

Development

# Clone the repository git clone https://github.com/MichaelReubenDev/sonarr-mcp.git cd sonarr-mcp # Install dependencies uv sync # Test with the MCP Inspector task mcp_inspector # Run with debug logging uv run sonarr-mcp --url http://localhost:8989 --api-token YOUR_TOKEN --debug

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Support

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables AI assistants to manage TV series collections through Sonarr's API using natural language interactions. Supports searching, adding, updating, and deleting TV series with detailed control over quality profiles, season monitoring, and episode downloads.

  1. Features
    1. Installation
      1. From PyPI (Recommended)
      2. From Source
    2. Usage
      1. Command Line
      2. With Claude Desktop
      3. With MCP Inspector
    3. Configuration
      1. Required Parameters
      2. Optional Parameters
    4. Available Tools
      1. Monitor Types
    5. Example Workflows
      1. Adding a TV Series
      2. Managing Your Collection
      3. Season-Specific Management
      4. Finding Downloads
    6. Requirements
      1. Development
        1. Contributing
          1. License
            1. Acknowledgments
              1. Support

                Related MCP Servers

                • Radarr and Sonarr MCP Server

                  BerryKuipers
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Python-based Model Context Protocol server that allows AI assistants like Claude to access and query your movie and TV show collection via Radarr and Sonarr APIs.
                  Last updated -
                  14

                • Perplexity Deep Research MCP

                  arjunkmrm
                  A
                  security
                  F
                  license
                  A
                  quality
                  A server that allows AI assistants to perform web searches using Perplexity's sonar-deep-research model with citation support.
                  Last updated -
                  1
                  8

                • MCP Qdrant Server with OpenAI Embeddings

                  amansingh0311
                  -
                  security
                  F
                  license
                  -
                  quality
                  This server enables semantic search capabilities using Qdrant vector database and OpenAI embeddings, allowing users to query collections, list available collections, and view collection information.
                  Last updated -
                  4

                • Overseerr MCP Server

                  reallycleansauce
                  -
                  security
                  F
                  license
                  -
                  quality
                  Enables interaction with Overseerr API to manage movie and TV show requests, allowing users to check server status and filter requests by various criteria.
                  Last updated -

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/MichaelReubenDev/sonarr-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server