MCP.so
Sign In
Q

qBittorrent MCP

@Igloo302

Repository

About qBittorrent MCP

本项目提供了一个通过MCP协议与QBittorrent WebUI进行交互的Python客户端，可以方便地管理QBittorrent中的种子。

#downloader

Basic information

Category

Other

Transports

stdio

Publisher

Igloo302

Submitted by

Igloo302

Config

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

{
  "mcpServers": {
    "qbittorrent-mcp": {
      "command": "uv",
      "args": [
        "run",
        "qbittorrent-mcp.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is qBittorrent MCP?

qBittorrent MCP is a Python client that interacts with the qBittorrent WebUI via the Model Context Protocol (MCP), enabling users to manage torrents in qBittorrent programmatically. It is designed for developers or automation workflows that need to control torrent tasks through MCP-based systems.

How to use qBittorrent MCP?

Ensure Python >= 3.7, clone the repository, and install dependencies with pip install -r requirements.txt. Configure the qBittorrent WebUI connection (host, port, username, password) in qbittorrent-mcp.py. Use the provided async functions, e.g., await connect(host, port, username, password) to connect, then call list_torrents(), pause_torrent(), resume_torrent(), delete_torrent(), or add_magnet() to manage torrents.

Key features of qBittorrent MCP

  • Connects to qBittorrent WebUI via MCP protocol
  • Lists all torrents in the qBittorrent client
  • Pauses and resumes individual torrents
  • Deletes specified torrents from the client
  • Adds new torrents using magnet links

Use cases of qBittorrent MCP

  • Remotely manage torrents by sending commands through MCP
  • Automate adding magnet links to qBittorrent
  • Pause or resume specific torrents programmatically
  • Remove unwanted torrents without manual intervention
  • Integrate torrent management into larger MCP-based workflows

FAQ from qBittorrent MCP

What Python version is required?

Python 3.7 or higher is required.

How do I configure the connection to qBittorrent WebUI?

Set the host, port, username, and password in the qbittorrent-mcp.py file.

What dependencies does qBittorrent MCP need?

The project depends on httpx and mcp, installed via pip install -r requirements.txt.

How can I add a magnet link to qBittorrent?

Use the add_magnet(magnet_url) async function after connecting.

How do I connect to the qBittorrent WebUI?

Call await connect(host, port, username, password) with your WebUI credentials.

Comments

More Other MCP servers

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Core Philosophy: Connect, Unify, Respond

mindsdb

Delegate anything. It comes back done.

39.4K

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K