qBittorrent MCP server CLI | TypeScript WebUI API binding
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add nqbtc --env QBITTORRENT_WEBUI_BASE_URL='<QBITTORRENT_WEBUI_BASE_URL>' -- npx nqbtc mcp '--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}' '--username={{config.QBITTORRENT_WEBUI_USERNAME}}' '--password={{config.QBITTORRENT_WEBUI_PASSWORD}}'~/.codex/config.toml
[mcp_servers.nqbtc]
command = "npx"
args = ["nqbtc", "mcp", "--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}", "--username={{config.QBITTORRENT_WEBUI_USERNAME}}", "--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"]
env = { QBITTORRENT_WEBUI_BASE_URL = "<QBITTORRENT_WEBUI_BASE_URL>" }
# codex mcp add nqbtc --env QBITTORRENT_WEBUI_BASE_URL='<QBITTORRENT_WEBUI_BASE_URL>' -- npx nqbtc mcp '--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}' '--username={{config.QBITTORRENT_WEBUI_USERNAME}}' '--password={{config.QBITTORRENT_WEBUI_PASSWORD}}'~/.cursor/mcp.json
{
"mcpServers": {
"nqbtc": {
"command": "npx",
"args": [
"nqbtc",
"mcp",
"--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}",
"--username={{config.QBITTORRENT_WEBUI_USERNAME}}",
"--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"
],
"env": {
"QBITTORRENT_WEBUI_BASE_URL": "<QBITTORRENT_WEBUI_BASE_URL>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"nqbtc": {
"type": "stdio",
"command": "npx",
"args": [
"nqbtc",
"mcp",
"--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}",
"--username={{config.QBITTORRENT_WEBUI_USERNAME}}",
"--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"
],
"env": {
"QBITTORRENT_WEBUI_BASE_URL": "<QBITTORRENT_WEBUI_BASE_URL>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"nqbtc": {
"command": "npx",
"args": [
"nqbtc",
"mcp",
"--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}",
"--username={{config.QBITTORRENT_WEBUI_USERNAME}}",
"--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"
],
"env": {
"QBITTORRENT_WEBUI_BASE_URL": "<QBITTORRENT_WEBUI_BASE_URL>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"nqbtc": {
"command": "npx",
"args": [
"nqbtc",
"mcp",
"--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}",
"--username={{config.QBITTORRENT_WEBUI_USERNAME}}",
"--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"
],
"env": {
"QBITTORRENT_WEBUI_BASE_URL": "<QBITTORRENT_WEBUI_BASE_URL>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"nqbtc": {
"command": "npx",
"args": [
"nqbtc",
"mcp",
"--base-url={{config.QBITTORRENT_WEBUI_BASE_URL}}",
"--username={{config.QBITTORRENT_WEBUI_USERNAME}}",
"--password={{config.QBITTORRENT_WEBUI_PASSWORD}}"
],
"env": {
"QBITTORRENT_WEBUI_BASE_URL": "<QBITTORRENT_WEBUI_BASE_URL>"
}
}
}
}Environment variables
QBITTORRENT_WEBUI_BASE_URL
Replace the placeholders with your own credentials and keep them out of version control.