Skip to main content
Glama
LtMarx

SABnzbd MCP

by LtMarx
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

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: NZBGet MCP Server

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
Install Server
F
license - not found
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • Transmission MCP Server

    cronus42
    A
    license
    -
    quality
    D
    maintenance
    Provides tools for interacting with the Transmission BitTorrent client via natural language, enabling users to manage torrents, configure download settings, and monitor download activity.
    Last updated
    2
    MIT

  • NZBGet MCP Server

    aserper
    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.
    Last updated
    15
    1
    MIT

  • downloader-mcp

    CarlDog
    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.
    Last updated
    10
    MIT

  • mcp-arr-suite

    ismael9291
    A
    license
    -
    quality
    B
    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.
    Last updated
    13
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Astravue MCP

    Manage projects, tasks, time tracking, and team collaboration through natural language.

  • Kody

    Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

  • DottedSign

    Automate eSignature workflows and signing tasks via natural language commands.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/LtMarx/SABnzbd-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server