- Explore MCP Servers
- sonarr-mcp
Sonarr Mcp
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.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
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.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
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 Sonarrfind-episodes
: Find episodes in Sonarrget-logs
: Get paginated logs from Sonarrlist-recent-downloads
: List recent downloads from Sonarrlist-upcoming-episodes
: List upcoming episodes from Sonarrsearch-series
: Search for a TV series by term
Available Resources
The following resources are available:
episode
: Retrieve information about a specific episode by IDquality-definition
: List quality definitions used by Sonarrquality-profiles
: List quality profiles configured in Sonarrseries
: 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
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.