Transmission MCP Server is an MCP server that connects Claude Desktop and other Model Context Protocol clients to the Transmission BitTorrent daemon. Designed for self-hosters, homelab enthusiasts, and system administrators, this server enables AI agents to manage active downloads, inspect transfer statuses, and check available disk storage across local or remote infrastructure. It interfaces directly with Transmission's RPC interface over HTTP or routes communication securely through a SOCKS5 proxy tunnel. Users can query torrent progress, retrieve detailed session information, start or stop selected items, and remove tasks with optional data deletion. By providing structured tools for network-attached torrent operations, the server allows operators to supervise their file transfer infrastructure through conversational interfaces without switching to the standard web UI. The codebase relies on Python, httpx, and pydantic, offering a lightweight implementation for automated and remote torrent administration.
Category: Other & General Purpose
Tags: bittorrent, file-transfer, torrent, transmission
bash git clone https://github.com/v-odoo-testing/transmission-mcp-server cd transmission-mcp-server 2. Create and activate a Python virtual environment, then install dependencies: bash python3 -m venv venv source venv/bin/activate pip install -r requirements.txt 3. Add the server entry to your Claude Desktop configuration file (claude_desktop_config.json): json { "mcpServers": { "transmission": { "command": "/path/to/transmission-mcp-server/venv/bin/python", "args": ["/path/to/transmission-mcp-server/src/server.py"], "env": { "TRANSMISSION_HOST": "192.168.1.205", "TRANSMISSION_PORT": "9091", "TRANSMISSION_USERNAME": "your_username", "TRANSMISSION_PASSWORD": "your_password", "USE_SOCKS5": "false" } } } } 4. Update file paths and daemon credentials to match your environment, then restart Claude Desktop.Part of MCP Servers
Transmission MCP Server is an integration tool that lets Model Context Protocol clients, such as Claude Desktop, interact with the Transmission torrent daemon. It provides automated control over torrent addition, status listing, transfers, and daemon configurations.
You can establish an SSH tunnel with SOCKS5 forwarding on your local port, set the SOCKS5 host and port parameters, and enable the SOCKS5 option directly in your command prompts when interacting through your client.
The server includes five primary tools: add_torrent for new URLs or magnet links, control_torrent to start, stop, or delete tasks, get_free_space to inspect storage, list_torrents for download status, and get_session_info for daemon settings.
Yes, Transmission MCP Server is open-source software released under the MIT License on GitHub.