Version: 0.1.7
qBittorrent Manager MCP Server + A2A Agent
AI agent for qBittorrent management, RSS automation, and search.
This repository is actively maintained - Contributions are welcome!
The MCP Server can be run in two modes: stdio (for local testing) or http (for networked access).
QBITTORRENT_URL: The URL of the target service.QBITTORRENT_PASSWORD: The API token or access token.
export QBITTORRENT_URL="http://localhost:8080"
export QBITTORRENT_PASSWORD="your_token"
qbittorrent-mcp --transport "stdio"export QBITTORRENT_URL="http://localhost:8080"
export QBITTORRENT_PASSWORD="your_token"
qbittorrent-mcp --transport "http" --host "0.0.0.0" --port "8000"export QBITTORRENT_URL="http://localhost:8080"
export QBITTORRENT_PASSWORD="your_token"
qbittorrent-agent --provider openai --model-id gpt-4o --api-key sk-...docker build -t qbittorrent-agent .docker run -d \
--name qbittorrent-agent \
-p 8000:8000 \
-e TRANSPORT=http \
-e QBITTORRENT_URL="http://your-service:8080" \
-e QBITTORRENT_PASSWORD="your_token" \
knucklessg1/qbittorrent-agent:latestservices:
qbittorrent-agent:
image: knucklessg1/qbittorrent-agent:latest
environment:
- HOST=0.0.0.0
- PORT=8000
- TRANSPORT=http
- QBITTORRENT_URL=http://your-service:8080
- QBITTORRENT_PASSWORD=your_token
ports:
- 8000:8000{
"mcpServers": {
"qbittorrent": {
"command": "uv",
"args": [
"run",
"--with",
"qbittorrent-agent",
"qbittorrent-mcp"
],
"env": {
"QBITTORRENT_URL": "http://your-service:8080",
"QBITTORRENT_PASSWORD": "your_token"
}
}
}
}python -m pip install qbittorrent-agentuv pip install qbittorrent-agent