Advertise
MCP.so
Sign In

Sabnzbd MCP Server

@zz-plant

Repository

Basic information

Category

Other

License

MIT

Author

zz-plant

About Sabnzbd MCP Server

MCP server for SABnzbd — control Usenet downloads from any AI agent. Zero external dependencies.

Sabnzbd MCP Server config

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

{
  "mcpServers": {
    "sabnzbd-mcp": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "sabnzbd-mcp",
        "."
      ]
    }
  }
}

Sabnzbd MCP Server tools

5

`sab_queue`

`sab_pause`

`sab_add_url`

`sab_queue_delete`

`sab_retry`

Overview

What is sabnzbd-mcp?

A Model Context Protocol (MCP) server for SABnzbd — a Usenet download manager. It gives any AI agent control over Usenet downloads. The server has zero external dependencies and is written in pure Python standard library.

How to use sabnzbd-mcp?

Install via pip: pip install sabnzbd-mcp. Set environment variables SABNZBD_URL and SABNZBD_API_KEY (or use a .env file or ~/.homelab.env). Run the command sabnzbd-mcp. It also runs in Docker. The server communicates over stdio using line-delimited JSON-RPC 2.0.

Key features of sabnzbd-mcp

  • Zero dependencies — pure Python standard library, one file.
  • 16 MCP tools for full queue, history, config, and category management.
  • Asynchronous notifications conforming to MCP standards.
  • Live resources and prompt templates for quick actions.
  • Shared .env support from ~/.homelab.env.
  • Works with any MCP client (Claude Desktop, Claude Code, Cursor, etc.).

Use cases of sabnzbd-mcp

  • Monitor the SABnzbd download queue and server status via AI agent.
  • Pause, resume, or set speed limits on active downloads.
  • Add new NZB downloads by URL or uploaded file with category assignment.
  • Browse download history and retry failed jobs.
  • Combine with other MCP servers (e.g., Prowlarr, Sonarr, RomM) for full media automation.

Frequently asked questions

1

What is sabnzbd-mcp and what does it do?

It is a Model Context Protocol server for SABnzbd that allows an AI agent to control Usenet downloads — view queues, add NZBs, manage history, and change server settings.

2

What dependencies does sabnzbd-mcp require?

None beyond the Python standard library. The server is a single self-contained file with zero external dependencies.

3

How do I configure sabnzbd-mcp?

Set the environment variables `SABNZBD_URL` (base URL of your SABnzbd instance) and `SABNZBD_API_KEY` (from Settings → General). Optionally, create a `.env` file in the current directory or a `~/.homelab.env` file in your home directory. Configuration via environment variables is also supported.

4

Which MCP clients are supported?

Any MCP host works, including Claude Desktop, Claude Code, Codex, OpenCode, Cursor, and Windsurf. Example configuration files for several clients are provided in the README.

5

How does sabnzbd-mcp communicate with the AI agent and SABnzbd?

It communicates with the AI agent over stdin/stdout using line-delimited JSON-RPC 2.0 (no Content-Length framing). It talks to the SABnzbd server over HTTP using the SABnzbd API.

Comments

More Other MCP servers

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K
N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K
Advertise