add_torrentLABSCO SUMMARY
Your home daemon, reachable from anywhere.
The proxy switch is per request rather than global, so the same server works on the home network and over a tunnel without being reconfigured.
What it is
An MCP server for the Transmission torrent daemon. It talks to the daemon over its RPC port, and any individual call can be routed through a SOCKS5 proxy for when you are away from the network the daemon sits on.
What you get
- A torrent added from a magnet link or torrent URL, into a chosen download directory
- Torrents started, stopped or removed, with or without deleting the local data
- All torrents listed with their current status
- Free disk space checked before a download starts
- Session settings read back from the daemon
- Any single call routed through a SOCKS5 proxy
Requirements
Python with the packages in requirements.txt and a reachable Transmission daemon. The daemon's host, port, username and password go in the environment; the SOCKS5 host and port are separate settings.
Setup effort
Build from source — git clone https://github.com/odoo-dgoo2308/transmission-mcp-server
USE CASES
01
Adding a download you just found
Hand over the magnet link and, if you want, the directory it should land in.
02
Checking what is running at home
List the torrents and their current status.
03
Pausing everything before a video call
Stop the torrents by ID and start them again afterwards.
04
Making sure there is room first
Check free space on the download path before adding anything large.
05
Connecting from outside the house
Set the SOCKS5 option on the call and it goes through the proxy.
5 tools
Listed in project docs. Your client may show a different list.
control_torrentget_free_spacelist_torrentsget_session_infoBEFORE YOU INSTALL
What to know first
Tools you get
5 tools named in the project's documentation. control_torrent with delete_data removes downloaded files from disk. Every tool takes use_socks5 for remote access.
Requires
- TRANSMISSION_PASSWORD in your environment
- TRANSMISSION_USERNAME in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/odoo-dgoo2308/transmission-mcp-server
cd transmission-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txtCopy the configuration from claude-desktop-config.json to your Claude Desktop config file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json), updating the paths to your system
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"transmission": {
"command": "<YOUR_PATH_TO_TRANSMISSION_MCP_SERVER>/venv/bin/python",
"args": [
"<YOUR_PATH_TO_TRANSMISSION_MCP_SERVER>/src/server.py"
],
"env": {
"TRANSMISSION_HOST": "192.168.1.205",
"TRANSMISSION_PORT": "9091",
"TRANSMISSION_USERNAME": "<YOUR_TRANSMISSION_USERNAME>",
"TRANSMISSION_PASSWORD": "<YOUR_TRANSMISSION_PASSWORD>",
"USE_SOCKS5": "false"
}
}
}
}
