@nasmcps/qbit-mcp

qBittorrent MCP Server - Model Context Protocol server for qBittorrent.

Features

• Add torrents (magnet links, torrent files, URLs)
• List and filter torrents
• Get detailed torrent information
• Pause/Resume torrents
• Delete torrents (with optional file deletion)
• Get global transfer information

Prerequisites

• Node.js 18 or higher
• qBittorrent with Web UI enabled

Quick Start (npx)

No installation required! Use npx to run directly:

npx @nasmcps/qbit-mcp

Installation (optional)

If you prefer to install globally:

npm install -g @nasmcps/qbit-mcp

Then run with:

qbit-mcp

Configuration

Set the following environment variables:

export QBT_URL=http://localhost:8080
export QBT_USERNAME=admin
export QBT_PASSWORD=your_password

Usage

Claude Desktop Configuration (npx)

Add to your Claude Desktop MCP configuration (claude_desktop_config.json):

macOS / Linux:

{
  "mcpServers": {
    "qbit": {
      "command": "npx",
      "args": ["@nasmcps/qbit-mcp"],
      "env": {
        "QBT_URL": "http://localhost:8080",
        "QBT_USERNAME": "admin",
        "QBT_PASSWORD": "your_password"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "qbit": {
      "command": "npx",
      "args": ["@nasmcps/qbit-mcp"],
      "env": {
        "QBT_URL": "http://localhost:8080",
        "QBT_USERNAME": "admin",
        "QBT_PASSWORD": "your_password"
      }
    }
  }
}

Alternative: Using global install

If you installed globally:

{
  "mcpServers": {
    "qbit": {
      "command": "qbit-mcp",
      "env": {
        "QBT_URL": "http://localhost:8080",
        "QBT_USERNAME": "admin",
        "QBT_PASSWORD": "your_password"
      }
    }
  }
}

Available Tools

• qbit_add_torrent - Add a torrent to qBittorrent
• qbit_get_torrents - Get list of torrents
• qbit_get_torrent_info - Get detailed torrent information
• qbit_pause_torrent - Pause torrents
• qbit_resume_torrent - Resume torrents
• qbit_delete_torrent - Delete torrents
• qbit_get_global_transfer_info - Get global transfer info

Development

# Clone repository
git clone https://github.com/nasmcps/qbit-mcp.git
cd qbit-mcp

# Install dependencies
npm install

# Build
npm run build

# Development mode
npm run dev

# Test locally
npm start

License

MIT