Skip to main content
Glama
SABnzbd MCP

SABnzbd MCP

by LtMarx

SABnzbd MCP

An MCP (Model Context Protocol) server for SABnzbd — manage your Usenet downloader through Claude or any MCP-compatible client.

Features

  • Queue management — view, pause, resume, delete, reorder and reprioritize downloads

  • History — browse, search, retry and delete completed/failed downloads

  • Add downloads — add NZBs by URL with optional category, priority and script

  • Speed control — set download speed limits on the fly

  • Status & info — server status, version, warnings, categories and scripts

  • Two transports — stdio (Claude Desktop) or HTTP (remote clients)

Related MCP server: downloader-mcp

Tools

Tool

Description

get_status

Full server status (speed, disk space, queue summary)

get_version

SABnzbd version

get_warnings

Current warnings and log messages

get_categories

All configured categories

get_scripts

All configured post-processing scripts

get_queue

Download queue with pagination

pause_queue

Pause all downloads

resume_queue

Resume all downloads

pause_post_processing

Pause post-processing

resume_post_processing

Resume post-processing

set_speed_limit

Set download speed limit

delete_from_queue

Delete items from the queue

set_priority

Set download priority

change_category

Change category of a queue item

move_in_queue

Move item to a specific queue position

add_nzb_url

Add NZB by URL

get_history

Download history with search and filtering

retry_download

Retry a failed download

retry_all_failed

Retry all failed downloads

delete_history

Delete history items

purge_history

Purge all history

Quick start

Docker (HTTP mode)

docker run -d \
  -e SABNZBD_URL=http://your-sabnzbd:8080 \
  -e SABNZBD_API_KEY=your_api_key \
  -e MCP_TRANSPORT=http \
  -p 3001:3001 \
  ghcr.io/ltmarx/sabnzbd-mcp:latest

Docker Compose

cp .env.example .env
# edit .env with your SABnzbd URL and API key
docker compose --profile http up -d

Claude Desktop (stdio)

{
  "mcpServers": {
    "sabnzbd": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "SABNZBD_URL=http://your-sabnzbd:8080",
        "-e", "SABNZBD_API_KEY=your_api_key",
        "ghcr.io/ltmarx/sabnzbd-mcp:latest"
      ]
    }
  }
}

Environment variables

Variable

Default

Description

SABNZBD_URL

http://localhost:8080

SABnzbd base URL

SABNZBD_API_KEY

(required)

SABnzbd API key (Settings → General → API Key)

MCP_TRANSPORT

stdio

Transport mode: stdio or http

MCP_PORT

3001

HTTP port (only used when MCP_TRANSPORT=http)

MCP_HOST

0.0.0.0

HTTP bind host (only used when MCP_TRANSPORT=http)

Health check

In HTTP mode the server exposes GET /health, which also verifies connectivity to SABnzbd:

  • 200 { "status": "ok", "sabnzbd": "reachable" } — server up and SABnzbd responding

  • 503 { "status": "error", "sabnzbd": "unreachable" } — server up but SABnzbd not reachable

The Docker image and docker-compose.yml both wire this into a container HEALTHCHECK for the HTTP service (checked every 30s). stdio mode has no persistent server, so no health check applies there.

Development

npm install
cp .env.example .env
# edit .env
npm run dev

Available Tools

21 tools
add_nzb_urlB

Add an NZB to the SABnzbd queue by URL

Inputs: url (required), category, priority, script.

change_categoryB

Change the category of a queue item

Inputs: id (required), category (required).

delete_from_queueB

Delete one or more items from the SABnzbd queue

Inputs: ids (required), delete_files.

delete_historyC

Delete one or more items from history

Inputs: ids (required), delete_files.

get_categoriesA

Get all configured download categories in SABnzbd

Inputs: no named parameters.

get_historyC

Get SABnzbd download history

Inputs: start, limit, failed_only, search.

get_queueB

Get the current SABnzbd download queue

Inputs: start, limit.

get_scriptsA

Get all configured post-processing scripts in SABnzbd

Inputs: no named parameters.

get_statusA

Get full SABnzbd server status including queue, disk space, speed and settings

Inputs: no named parameters.

get_versionA

Get the SABnzbd version

Inputs: no named parameters.

get_warningsA

Get current SABnzbd warnings and log messages

Inputs: no named parameters.

move_in_queueB

Move a queue item to a specific position

Inputs: id (required), position (required).

pause_post_processingB

Pause SABnzbd post-processing (repair, unpack, scripts)

Inputs: no named parameters.

pause_queueA

Pause all SABnzbd downloads

Inputs: no named parameters.

purge_historyA

Purge all completed downloads from history

Inputs: delete_files.

resume_post_processingA

Resume SABnzbd post-processing

Inputs: no named parameters.

resume_queueB

Resume all SABnzbd downloads

Inputs: no named parameters.

retry_all_failedA

Retry all failed downloads in history

Inputs: no named parameters.

retry_downloadB

Retry a failed download from history

Inputs: id (required), url.

set_priorityC

Set the download priority for a queue item

Inputs: id (required), priority (required).

set_speed_limitA

Set the SABnzbd download speed limit. Use 0 for unlimited, a number for KB/s, or append M for MB/s (e.g. '5M')

Inputs: limit (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 21 tools

    Disambiguation5/5

    Every tool targets a distinct operation on SABnzbd resources (queue, history, categories, etc.), with clear descriptions. Overlapping concerns like pause_queue vs pause_post_processing are properly differentiated.

    Naming Consistency5/5

    All tools use a consistent verb_noun pattern with underscores and same stylistic choices (e.g., pause_queue, resume_queue, retry_download, set_speed_limit). No mixing of conventions.

    Tool Count5/5

    21 tools cover the full SABnzbd interaction surface without excess. Each tool serves a clear purpose, and the number is well-balanced for a download manager API.

    Completeness5/5

    The tool set covers the complete lifecycle: adding NZBs, managing queue/history, controlling downloads and post-processing, and retrieving status information. No obvious missing operations for standard usage.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables users to control and monitor NZBGet Usenet downloads through natural language using MCP-compatible clients. It provides 17 tools for managing download queues, tracking history, and adjusting server settings like speed limits.
      15
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables interaction with SABnzbd (usenet) and qBittorrent (torrent) download clients through their APIs. Each client is optional and only tools for configured clients are registered.
      10
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables interaction with the *arr media management suite (Sonarr, Radarr, Lidarr, Prowlarr, SABnzbd) and TRaSH Guides through MCP tools, allowing media library management, searching, and configuration via natural language.
      70
      16 npm
      1
      MIT