MCP.so
Sign In
Q

qBittorrent MCP Server

@Igloo302

Basic information

Category

Other

Transports

stdio

Author

Igloo302

Submitted by

Igloo302

About qBittorrent MCP Server

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

qBittorrent MCP Server config

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

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

qBittorrent MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

What Python version is required?

Python 3.7 or higher is required.

2

How do I configure the connection to qBittorrent WebUI?

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

3

What dependencies does qBittorrent MCP need?

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

4

How can I add a magnet link to qBittorrent?

Use the `add_magnet(magnet_url)` async function after connecting.

5

How do I connect to the qBittorrent WebUI?

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

Comments

More Other MCP servers