MCP.so
Sign In

Sonarr MCP Server

@Jacques-Murray

Basic information

Category

Other

Transports

stdio

Author

Jacques-Murray

About Sonarr MCP Server

No overview available yet

Sonarr MCP Server 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"
      ]
    }
  }
}

Sonarr MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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.

3

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.

4

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.

5

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