nqbtc

Run qBittorrent MCP server, and TypeScript qBittorrent WebUI API binding.

Run qBittorrent MCP server.

• Node.js 24 or newer
• qBittorrent and make sure WebUI enabled
• Any MCP client

Standard config works in most of the tools (replace the --base-url=... with your real qBittorrent WebUI url).

{
  "mcpServers": {
    "nqbtc": {
      "command": "npx",
      "args": [
        "nqbtc",
        "mcp",
        "--base-url=http://localhost:9091/api/v2"
      ]
    }
  }
}

You can also config username and password of WebUI with --username=xxx and --password=yyy options. Add these options your MCP command args.

npx nqbtc mcp --base-url=http://localhost:9091/api/v2 --username=xxx --password=yyy

It also read local .env file and accept following configurations.

QBITTORRENT_WEBUI_BASE_URL=http://localhost:9091/api/v2
QBITTORRENT_WEBUI_USERNAME=
QBITTORRENT_WEBUI_PASSWORD=

npm i nqbt

import { QBittorrent } from 'nqbt';

const client = new QBittorrent({
  baseURL: 'http://localhost:9091/api/v2',
  username: 'admin',
  password: 'adminadmin'
});

await client.login();

const version = await client.getApplicationVersion();
console.log('qBittorrent version:', version);

const torrents = await client.getTorrentList({
  filter: 'downloading',
  sort: 'dlspeed',
  reverse: true,
  limit: 10
});

console.log('downloading torrents:', torrents.length);

if (torrents[0]) {
  // qBittorrent v5 uses stop/start; v4 uses pause/resume.
  // Both method pairs are kept and auto-switch internally.
  await client.stopTorrents(torrents[0].hash);
  await client.startTorrents(torrents[0].hash);

  // Equivalent aliases:
  // await client.pauseTorrents(torrents[0].hash);
  // await client.resumeTorrents(torrents[0].hash);
}

await client.addNewMagnet('magnet:?xt=urn:btih:<YOUR_INFO_HASH>', {
  category: 'demo',
  tags: 'sample',
  paused: true
});

await client.logout();

Official docs:

• WebUI API (qBittorrent 5.0)
• WebUI API (qBittorrent 4.1)

Support TypeScript API:

Compatibility note

• stopTorrents and pauseTorrents are both available; both auto-switch to /torrents/stop (v5) or /torrents/pause (v4).
• startTorrents and resumeTorrents are both available; both auto-switch to /torrents/start (v5) or /torrents/resume (v4).

This package is used to power AnimeSpace, offering a comprehensive solution for automatically following bangumis. It can fetch anime resources, download desired video content, and upload them to the local file system or remote WebDAV server. The downloading process is facilitated by this package.

• qBittorrent
• @ctrl/qbittorrent

MIT License © 2025 XLor