Transmission MCP Server

An MCP server for controlling the Transmission torrent daemon.

A simple MCP server for controlling your Transmission torrent daemon. Supports both direct connection and SOCKS5 proxy for remote access.

git clone <this-repo> cd transmission-mcp-server python3 -m venv venv source venv/bin/activate pip install -r requirements.txt

Copy the configuration fromclaude-desktop-config.jsonto your Claude Desktop config file:

macOS:~/Library/Application Support/Claude/claude_desktop_config.json

Important: Update the paths to match your system and use the venv Python:/path/to/transmission-mcp-server/venv/bin/python

{ "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" } } } }

For SOCKS5 proxy usage(when away from home): Use theuse_socks5: trueparameter in your commands to Claude

- TRANSMISSION_HOST: IP address of Transmission daemon (default: 192.168.1.205)
- TRANSMISSION_PORT: Port number (default: 9091)
- TRANSMISSION_USERNAME: Username for authentication
- TRANSMISSION_PASSWORD: Password for authentication
- USE_SOCKS5: Enable SOCKS5 proxy (true/false, default: false)
- SOCKS5_HOST: SOCKS5 proxy host (default: 127.0.0.1)
- SOCKS5_PORT: SOCKS5 proxy port (default: 1080)
- TRANSMISSION_TIMEOUT: Request timeout in seconds (default: 30)

Add a new torrent via magnet link or URL.

- magnet_or_url: Magnet link or torrent file URL
- download_dir: Optional custom download directory
- use_socks5: Use SOCKS5 proxy for this request (default: false)

- action: "start", "stop", or "remove"
- torrent_ids: Array of torrent IDs
- delete_data: Whether to delete local data when removing (default: false)
- use_socks5: Use SOCKS5 proxy for this request (default: false)

Check available disk space for downloads.

- path: Optional directory path to check
- use_socks5: Use SOCKS5 proxy for this request (default: false)

List all torrents with their status, progress, and download directories.

- use_socks5: Use SOCKS5 proxy for this request (default: false)

Get information about the Transmission daemon session, including version, settings, and statistics.

- use_socks5: Use SOCKS5 proxy for this request (default: false)

After setting up Claude Desktop, you can use these commands:

- "Show me all my torrents"
- "Add this magnet link: magnet:?xt=urn:btih:..."
- "Stop torrent ID 5"
- "How much free space do I have?"

- "Use SOCKS5 to show me all my torrents"
- "Use SOCKS5 proxy to add this magnet link: magnet:?xt=urn:btih:..."
- "Use SOCKS5 to stop torrent ID 5"
- "Use SOCKS5 to get free space"

Use when your laptop is on the same network as the Transmission server.

Set up a SOCKS5 tunnel when away from home, then useuse_socks5: truein your commands:

# SSH tunnel with SOCKS5 ssh -D 1080 -N user@your-home-server.com

Then tell Claude:"Use SOCKS5 to add this magnet link..."

- Verify Transmission daemon is running and accessible
- Check firewall settings on the Transmission server
- Ensure RPC is enabled in Transmission settings
- Verify username/password if authentication is required

- Confirm SOCKS5 proxy is running on specified host:port
- Test SOCKS5 connectivity with another tool first
- Check if authentication is required for your SOCKS5 proxy

- Verify username/password in environment variables
- Check if Transmission requires authentication
- Ensure RPC whitelist includes your client IP

The server is contained in a single file (src/server.py) for simplicity. It uses:

- httpxfor HTTP requests
- pydanticfor configuration management
- mcpfor the Model Context Protocol integration

MIT License - see LICENSE file for details.

Parses various file formats using the 302.AI API, requiring a 302AI_API_KEY.

A local server that allows AI to execute Windows CMD commands, read/write files, and manage directories within a specified path.

Filesystem agent memory working with consolidation Daemon on your machine

An AI-powered MCP server for advanced file system operations, including search, comparison, and security analysis.

Securely browse and read files within an Android project, with built-in validation and access controls for sensitive directories.

Build a persistent, local knowledge base in Markdown files through conversations with LLMs.

A read-only MCP server for querying live FTP data using the CData JDBC Driver.

An MCP server for viewing, editing, and creating text files, based on the Claude built-in text editor tool.

Convert PDF, Word, Excel, PowerPoint, EPUB, HEIC and images from Claude or Cursor, with 35 converters exposed through just two MCP tools.

A cross-platform filesystem server for Linux, macOS, and Windows with secure path restrictions.