QBittorrent

Provides interfaces to manage qBittorrent WebUI via MCP for torrent, tracker, speed, and system operations.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pickpppcc-qbittorrent-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/workspace/PC-Canary/apps/qBittorrent/qbittorrent_mcp",
        "run",
        "qbittorrent.py"
      ],
      "env": {
        "DEFAULT_HOST": "http://localhost:8080",
        "DEFAULT_PASSWORD": "changeme",
        "DEFAULT_USERNAME": "admin"
      }
    }
  }
}

qBittorrent MCP provides a programmable interface to the qBittorrent WebUI API, enabling you to manage torrents, trackers, speeds, and system information through a lightweight MCP server. This makes it easy to automate torrent operations from your preferred MCP client or automation workflow.

How to use

You will run a local MCP server that exposes a set of endpoints to interact with qBittorrent WebUI. Connect your MCP client to the server, then call functions to add torrents, pause or resume downloads, adjust speed limits, manage trackers and tags, or query application version. Use the available functions to build automation for batch torrent management, monitoring, and deployment pipelines.

How to install

Prerequisites you need before starting: Python 3.8+ and a shell environment.

pip install httpx mcp

Additional sections

Configuration details you will set for the MCP server include the WebUI host, username, and password needed to authenticate with qBittorrent WebUI.

Run the MCP service using Python after dependencies are installed.

python main.py

Available tools

add_torrent

Add torrent files to qBittorrent by providing torrent data or a magnet link.

delete_torrent

Delete specified torrents, with an option to delete the downloaded files from disk.

pause_torrent

Pause active torrent downloads.

resume_torrent

Resume paused torrent downloads.

get_torrent_list

Retrieve the list of all torrents in qBittorrent.

search_torrents

Search for torrents based on given criteria.

get_torrent_trackers

Fetch the tracker list for a specific torrent.

add_trackers_to_torrent

Attach new trackers to a torrent.

add_torrent_tags

Attach tags to a torrent for categorization.

set_global_download_limit

Set the global download speed limit for all torrents.

set_global_upload_limit

Set the global upload speed limit for all torrents.

set_torrent_download_limit

Set a download speed limit for a specific torrent.

set_torrent_upload_limit

Set an upload speed limit for a specific torrent.

set_file_priority

Set the download priority for a specific file within a torrent.

get_application_version

Return the qBittorrent application version.

Built by

VeilStrat

AI signals for GTM teams