Sonarr MCP Server

Name: Sonarr MCP Server
Author: Jacques-Murray

@Jacques-Murray

Repository

About Sonarr MCP Server

No overview available yet

#sonarr #mcp #ai-assistant

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "sonarr-mcp-server": {
      "command": "docker",
      "args": [
        "pull",
        "ghcr.io/jacques-murray/sonarr-mcp-server:latest"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Sonarr MCP Server?

Sonarr MCP Server is a Model Context Protocol (MCP) server that enables AI assistants to manage TV series in Sonarr through natural language commands. It integrates with Sonarr’s API v4 and is intended for users of AI assistants that support MCP, such as Claude Desktop or Continue.dev.

How to use Sonarr MCP Server?

Install Node.js 18+, npm 8+, and a running Sonarr 4.x instance with an API key. Clone the repository, run npm install, copy .env.example to .env and fill in your Sonarr URL and API key, then build with npm run build. Start the server with npm start or use Docker. Integrate with an AI assistant by adding the server’s stdio command to the client’s MCP configuration (e.g., claude_desktop_config.json). Test the connection by running npm run start -- --test.

Key features of Sonarr MCP Server

Add, list, update, and remove TV series
Search for and monitor missing episodes
View and control the download queue
Check system health, disk space, and activity
Access quality profiles, root folders, and calendar

Use cases of Sonarr MCP Server

Add a new series with a specific quality profile via natural language
Search for missing episodes across all series
Check current download progress and manage stuck items
View upcoming episodes and air dates on your calendar
Remove a series while optionally keeping its files

FAQ from Sonarr MCP Server

What are the prerequisites for running Sonarr MCP Server?

Node.js 18.0.0 or higher, npm 8.0.0 or higher, and a running Sonarr 4.x instance with a valid API key.

How do I get my Sonarr API key?

In the Sonarr web interface, go to Settings → General, scroll to the Security section, and copy the API Key value. Use this as the SONARR_API_KEY environment variable.

How do I integrate Sonarr MCP Server with Claude Desktop?

Add a claude_desktop_config.json entry with the command pointing to the built dist/index.js and the required environment variables (SONARR_API_URL, SONARR_API_KEY). See the README for the exact JSON snippet.

How can I test the server connection?

Run npm run start -- --test for a local install, or check the logs with docker logs sonarr-mcp-server when using Docker.

What transport does the server use?

The server communicates via stdio (standard input/output) following the MCP protocol specification. No HTTP transport is mentioned.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K