SABnzbd MCP
This server acts as an MCP interface for SABnzbd, allowing you to manage your Usenet downloads through a conversational client like Claude.
Queue Management
View the download queue (with pagination), pause/resume all downloads
Delete items from the queue, with optional file deletion
Set download priority (paused, low, normal, high, force), change category, and reorder items
Post-Processing
Pause and resume post-processing activities (repair, unpack, scripts)
Adding Downloads
Add NZB files by URL, optionally specifying category, priority, and post-processing script
History
Browse completed/failed downloads with pagination, search, and failed-only filtering
Retry individual failed downloads (optionally with a new NZB URL) or retry all failed downloads at once
Delete specific history items or purge all history, with optional file deletion
Speed & Status
Set a global download speed limit (unlimited, KB/s, or MB/s)
Get full server status (speed, disk space, queue summary), version, and active warnings/logs
Configuration Info
List all configured categories and post-processing scripts
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SABnzbd MCP show me my current download queue"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Full server status (speed, disk space, queue summary) |
| SABnzbd version |
| Current warnings and log messages |
| All configured categories |
| All configured post-processing scripts |
| Download queue with pagination |
| Pause all downloads |
| Resume all downloads |
| Pause post-processing |
| Resume post-processing |
| Set download speed limit |
| Delete items from the queue |
| Set download priority |
| Change category of a queue item |
| Move item to a specific queue position |
| Add NZB by URL |
| Download history with search and filtering |
| Retry a failed download |
| Retry all failed downloads |
| Delete history items |
| 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:latestDocker Compose
cp .env.example .env
# edit .env with your SABnzbd URL and API key
docker compose --profile http up -dClaude 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 base URL |
| (required) | SABnzbd API key (Settings → General → API Key) |
|
| Transport mode: |
|
| HTTP port (only used when |
|
| HTTP bind host (only used when |
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 responding503 { "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 devAvailable Tools
21 toolsadd_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
Scored across 21 tools
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.
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.
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.
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
Related MCP Connectors
3D print farm management for AI. Monitor, queue, and control prints on your SimplyPrint account.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Log, query, and edit expenses, budgets, and accounts in Manilo from any MCP-compatible AI assistant.
Interact with the Stitch API using natural language commands.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables 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.151MIT
- AlicenseAqualityBmaintenanceEnables interaction with SABnzbd (usenet) and qBittorrent (torrent) download clients through their APIs. Each client is optional and only tools for configured clients are registered.10MIT
- AlicenseAqualityDmaintenanceEnables 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.7016 npm1MIT
- AlicenseBqualityDmaintenanceEnables control and management of a self-hosted media stack (Radarr, Sonarr, Prowlarr, SABnzbd, qBittorrent) through natural language via MCP.15GPL 3.0