MCP ExplorerExplorer

Sonarr Mcp

@jbydeleyon a month ago
1 MIT
FreeCommunity
AI Systems
#mcp#mcp-server#sonarr#sonarr-api
Give your LLM access to Sonarr

Overview

What is Sonarr Mcp

sonarr-mcp is a Model Context Protocol (MCP) server designed to provide programmatic access to Sonarr, a tool for managing and automating the downloading of TV series.

Use cases

Use cases for sonarr-mcp include automating the addition of new TV series, retrieving information about upcoming episodes, managing downloads, and integrating Sonarr with other applications or services that require access to TV series data.

How to use

To use sonarr-mcp, add it to your MCP configuration by including the server details in your JSON config file. Ensure you provide the Sonarr URL and API key for authentication.

Key features

Key features of sonarr-mcp include adding series, finding episodes, retrieving logs, listing recent downloads, and searching for TV series. It also provides resources for episode and series information, as well as quality definitions and profiles.

Where to use

sonarr-mcp can be used in various domains where media management is required, particularly in home media setups, automation scripts, and applications that need to interact with Sonarr for TV series management.

Content

Sonarr MCP Server

This is a Model Context Protocol (MCP) server for accessing Sonarr. It provides a set of tools for interacting with Sonarr programmatically and it’s awesome!

Available Tools

The following tools are available:

  • add-series: Add a series to Sonarr
  • find-episodes: Find episodes in Sonarr
  • get-logs: Get paginated logs from Sonarr
  • list-recent-downloads: List recent downloads from Sonarr
  • list-upcoming-episodes: List upcoming episodes from Sonarr
  • search-series: Search for a TV series by term

Available Resources

The following resources are available:

  • episode: Retrieve information about a specific episode by ID
  • quality-definition: List quality definitions used by Sonarr
  • quality-profiles: List quality profiles configured in Sonarr
  • series: Retrieve information about a specific series by ID

Usage

To add this server to your MCP config, add the following:

{
  "mcpServers": {
    "sonarr": {
      "command": "npx",
      "args": [
        "-y",
        "sonarr-mcp"
      ],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "<your-sonarr-api-key>"
      }
    }
  }
}

You can get your sonarr api key from the sonarr web ui under Settings > API > API Key.

Here’s a diagram of how the tools and resources can be used:

flowchart LR
    subgraph User
      U((User/Agent))
    end

    subgraph Tools
      A[Search Series]
      B[Find Episodes]
      D[List Upcoming Episodes]
      E[Add Series]
      G[List Downloads]
      I[Get Logs]
    end

    subgraph Resources
      C[Episode Resource]
      F[Series Resource]
      H[Quality Profiles]
    end

    U --> A
    U --> B
    U --> D
    U --> E
    U --> G
    U --> I

    A --> B
    B --> C
    D --> C
    E --> F
    G --> H
    I

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers