@william.wigemo/sonarr-mcp

MCP server for Sonarr.

Installation

npx @william.wigemo/sonarr-mcp

Configuration

Environment Variables

| Variable | Required | Default | Description | |---|---|---|---| | SONARR_URL | Yes | - | Base URL of your Sonarr instance (e.g. http://localhost:8989) | | SONARR_API_KEY | Yes | - | Sonarr API key | | SONARR_ALLOW_WRITE | No | false | Set to true to enable write operations |

Write operations (tools marked with *) are disabled by default. Set SONARR_ALLOW_WRITE=true to enable them.

Tools

Read-Only

| Tool | Description | |---|---| | list_series | List all TV series in the Sonarr library | | get_series | Get details for a specific series by ID | | search_series | Search for TV series by name using TVDB | | list_episodes | List episodes for a given series | | get_queue | Get the active download queue | | get_queue_details | Get detailed queue information | | search_releases | Search for available releases to download for a series or episode | | get_calendar | Get upcoming episodes from the calendar | | get_history | Get download and import history | | get_missing_episodes | Get episodes that are missing | | get_cutoff_episodes | Get episodes that have not met quality cutoff | | list_commands | List currently running and queued commands | | get_command | Get a specific command by ID | | list_episode_files | List episode files for a series | | get_episode_file | Get an episode file by ID |

Write (require SONARR_ALLOW_WRITE=true)

| Tool | Description | |---|---| | add_series | Add a new series to the Sonarr library | | update_series | Update an existing series | | delete_series | Delete a series from the library | | bulk_update_series | Update multiple series at once | | bulk_delete_series | Delete multiple series at once | | update_episode_monitoring | Enable or disable monitoring for a specific episode | | remove_queue_item | Remove an item from the download queue | | grab_queue_item | Force grab a queue item | | download_release | Send a release to the download client | | send_command | Send a command to Sonarr (e.g. EpisodeSearch, RefreshSeries) | | update_episode_file | Update an episode file | | delete_episode_file | Delete an episode file |

Resources

| URI | Description | |---|---| | sonarr://series | List all series in the library | | sonarr://series/{id} | Get a specific series by ID | | sonarr://queue | Active download queue snapshot | | sonarr://calendar | Upcoming episodes from the Sonarr calendar | | sonarr://history | Recent download and import history | | sonarr://wanted/missing | Episodes that are missing and wanted | | sonarr://wanted/cutoff | Episodes that have not met their quality cutoff | | sonarr://commands | Currently running and queued commands |

Usage Examples

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "sonarr": {
      "command": "npx",
      "args": ["@william.wigemo/sonarr-mcp"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "sonarr": {
      "command": "npx",
      "args": ["@william.wigemo/sonarr-mcp"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-api-key"
      }
    }
  }
}

Requirements

• Node.js 18 or later

License

MIT