Sonarr MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SONARR_URL | Yes | Your Sonarr URL (e.g., http://localhost:8989) | |
| SONARR_API_KEY | Yes | Your Sonarr API key (Settings > General > API Key) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| sonarr_search_seriesA | Search for TV series by title on TVDB/TMDB. Returns potential matches with metadata. Use this to find the tvdbId needed to add a series. |
| sonarr_get_all_seriesA | Get all series in your Sonarr library. Returns complete list with metadata, seasons, and statistics. |
| sonarr_get_seriesA | Get detailed information about a specific series by its Sonarr ID. Includes all seasons, episodes, and statistics. |
| sonarr_get_series_by_tvdbA | Get series information by TVDB ID. Useful when you know the TVDB ID but not the Sonarr ID. |
| sonarr_add_seriesB | Add a new TV series to your library. You need the tvdbId from sonarr_search_series. Optionally specify root folder path, quality profile, and which seasons to monitor. |
| sonarr_delete_seriesA | Delete a series from Sonarr. Optionally delete files from disk. WARNING: This cannot be undone! |
| sonarr_get_episodesB | Get all episodes for a specific series. Returns episode list with air dates, file status, and monitoring status. |
| sonarr_get_episodeC | Get detailed information about a specific episode by its episode ID. |
| sonarr_search_episodesA | Search for specific episodes to download. This sends the episode to your download client. Use episodeIds from sonarr_get_episodes. |
| sonarr_search_seasonA | Search for all episodes in a specific season. This sends the entire season to your download client. |
| sonarr_search_series_commandB | Search for all monitored episodes across a series. This is the 'Search All' button functionality. |
| sonarr_get_queueB | Get current download queue. Shows active downloads, their progress, status, and any errors. |
| sonarr_remove_from_queueB | Remove an item from the download queue. Optionally blocklist the release to prevent re-download. |
| sonarr_get_wantedA | Get wanted/missing episodes. Shows episodes that are monitored but don't have files yet. |
| sonarr_get_calendarC | Get episodes airing in a date range. Defaults to the next week. Great for seeing what's coming up. |
| sonarr_get_healthB | Get system health status. Shows any warnings or errors with your Sonarr instance (disk space, download client issues, etc.). |
| sonarr_get_system_statusA | Get system status information. Shows version, OS, .NET version, database type, and migration version. |
| sonarr_get_quality_profilesA | Get all quality profiles. Shows available quality settings you can use when adding series. |
| sonarr_get_language_profilesB | Get all language profiles. Shows available language settings for series. |
| sonarr_get_root_foldersA | Get all configured root folders. Shows where series can be stored. |
| sonarr_get_tagsA | Get all tags. Shows available tags you can apply to series for organization. |
| sonarr_edit_seriesA | Edit an existing series. Update monitored status, quality profile, path, or tags. Get the full series object first with sonarr_get_series, modify it, and pass it here. |
| sonarr_refresh_seriesC | Refresh series information from metadata sources. Updates episode info, air dates, etc. |
| sonarr_rescan_seriesB | Rescan series folder for files. Checks for new, modified, or deleted episode files. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 24 tools
Most tools are clearly distinct: retrieval (get_series, get_all_series, get_series_by_tvdb), mutations (add, delete, edit), and search commands (search_episodes, search_season, search_series_command) have specific purposes. However, the three search tools could be confused: sonarr_search_series (metadata search) vs. sonarr_search_series_command (download trigger) is subtle and may cause misselection.
All tool names follow a consistent snake_case pattern with the 'sonarr_' prefix and verb_noun structure (e.g., sonarr_get_series, sonarr_add_series, sonarr_delete_series). Minor variations like 'get_all_series' and 'search_series_command' are still readable and predictable.
24 tools is on the heavy side for a single media manager, but they cover distinct aspects of the Sonarr API (series, episodes, queue, system). Some tools like get_language_profiles and get_tags could be considered niche, but overall the count is borderline rather than excessive.
The surface covers core CRUD for series (search, get, add, edit, delete), episode retrieval, download queue management, and system diagnostics. Missing operations include direct episode monitoring (e.g., set monitored status) and series import/export, but agents can work around these using the provided tools.