transmission-mcp
Provides tools to manage the Transmission BitTorrent client, including adding, removing, pausing, resuming torrents, managing queue order, configuring session settings, and monitoring statistics.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@transmission-mcp what torrents are currently downloading"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Transmission MCP Server
Model Context Protocol (MCP) server for the Transmission BitTorrent client. This server provides comprehensive tools to manage torrents, control the Transmission daemon, and monitor downloads through a standardized MCP interface.
Features
Torrent Management: Add, remove, pause, resume, and verify torrents
Queue Control: Manage download queue order
Session Management: Configure Transmission daemon settings
Real-time Monitoring: Get torrent status, statistics, and progress
File Operations: Move torrents, check free space
Flexible Output: Support for both human-readable Markdown and machine-readable JSON formats
Related MCP server: transmission-mcp
Prerequisites
Node.js 18 or higher
Transmission daemon running locally or remotely
Transmission RPC credentials (if authentication is enabled)
Installation
npm install
npm run buildConfiguration
The server requires the Transmission daemon connection details via environment variables:
TRANSMISSION_URL- Base URL of Transmission RPC (default:http://localhost:9091)TRANSMISSION_USERNAME- Username for authentication (optional)TRANSMISSION_PASSWORD- Password for authentication (optional)
Example:
export TRANSMISSION_URL="http://localhost:9091"
export TRANSMISSION_USERNAME="admin"
export TRANSMISSION_PASSWORD="password"Usage
With Claude Desktop
Add to your Claude Desktop configuration:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"transmission": {
"command": "node",
"args": ["/path/to/transmission-mcp/dist/index.js"],
"env": {
"TRANSMISSION_URL": "http://localhost:9091",
"TRANSMISSION_USERNAME": "your-username",
"TRANSMISSION_PASSWORD": "your-password"
}
}
}
}Standalone
npm startAvailable Tools
Torrent Management
transmission_add_torrent- Add torrent from magnet URI, URL, or base64-encoded .torrent filetransmission_list_torrents- List all torrents with optional filteringtransmission_get_torrent- Get detailed information about specific torrent(s)transmission_remove_torrent- Remove torrent with option to delete local filestransmission_pause_torrent- Pause active torrent(s)transmission_resume_torrent- Resume paused torrent(s)transmission_verify_torrent- Verify torrent data integritytransmission_reannounce_torrent- Force tracker reannouncetransmission_move_torrent- Move torrent to new locationtransmission_set_torrent- Update torrent settings (labels, priorities, limits)
Queue Management
transmission_queue_move- Move torrents in download queue (top/up/down/bottom)
Session Management
transmission_get_session- Get Transmission daemon configurationtransmission_set_session- Update daemon settingstransmission_get_stats- Get session statistics (current and cumulative)
Utility
transmission_free_space- Check available disk space
Development
# Install dependencies
npm install
# Run in development mode with auto-reload
npm run dev
# Build the project
npm run build
# Clean build artifacts
npm run cleanLicense
MIT
Available Tools
15 toolstransmission_add_torrentAdd Torrent to TransmissionA
Add a new torrent to Transmission from a magnet URI, HTTP(S) URL, or base64-encoded .torrent file.
This tool adds torrents to the Transmission download queue. It supports multiple input formats and allows configuration of download location, initial state, and labels.
Args:
torrent (string): Magnet URI (magnet:?...), HTTP(S) URL to .torrent file, or base64-encoded .torrent file content
download_dir (string, optional): Destination directory for downloaded files
paused (boolean, optional): If true, add torrent in paused state (default: false)
labels (string[], optional): Array of labels to apply to the torrent
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For JSON format: { id: number, name: string, hashString: string } For Markdown format: Human-readable confirmation with torrent details
Examples:
Use when: "Add this magnet link to downloads" -> params with magnet URI
Use when: "Download torrent from URL and label it 'movies'" -> params with URL and labels
Don't use when: You need to search for torrents (this only adds existing torrent files/magnets)
Error Handling:
Returns "Error: Could not connect to Transmission daemon" if connection fails
Returns "Torrent added successfully" on success with torrent details
Inputs: torrent (required), labels, paused, download_dir, +1 more.
transmission_free_spaceCheck Free Disk SpaceARead-onlyIdempotent
Check available disk space at a given path.
This tool checks how much free space is available at the specified path. If no path is provided, it checks the default download directory.
Args:
path (string, optional): Path to check (defaults to download directory)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Available free space in bytes and human-readable format
Examples:
Use when: "How much disk space is available?"
Use when: "Check free space in /downloads" -> params with path="/downloads"
Use when: "Do I have enough space for more downloads?"
Error Handling:
Returns error if path doesn't exist or is not accessible
Inputs: path, response_format.
transmission_get_sessionGet Session ConfigurationARead-onlyIdempotent
Get Transmission daemon configuration and settings.
This tool retrieves the current configuration of the Transmission daemon, including speed limits, download directory, and seeding settings.
Args:
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Complete session configuration including:
Version information
Download directory
Speed limits (regular and alternative)
Seed ratio settings
Port and network configuration
Examples:
Use when: "Show Transmission settings"
Use when: "What's my download directory?"
Use when: "Check current speed limits"
Error Handling:
Returns error if cannot connect to Transmission daemon
Inputs: response_format.
transmission_get_statsGet Session StatisticsARead-onlyIdempotent
Get Transmission session statistics including current and cumulative data.
This tool retrieves statistics about the current and all-time Transmission usage, including download/upload totals, active torrents, and speeds.
Args:
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Statistics including:
Current session: Active/paused torrents, current speeds
Session totals: Downloaded/uploaded bytes, files added, duration
All-time totals: Cumulative statistics across all sessions
Examples:
Use when: "Show me download statistics"
Use when: "How much have I downloaded total?"
Use when: "What's my current upload speed?"
Error Handling:
Returns error if cannot connect to Transmission daemon
Inputs: response_format.
transmission_get_torrentGet Torrent DetailsARead-onlyIdempotent
Get detailed information about specific torrent(s) by ID.
This tool retrieves comprehensive information about one or more torrents, including status, progress, files, trackers, and peer information.
Args:
ids (number | number[] | 'all'): Torrent ID(s) - single ID, array of IDs, or 'all' for all torrents
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Detailed torrent information including:
Name, status, and progress
Size and download/upload statistics
Speed and ETA
Peer connections
Labels and error messages (if any)
Examples:
Use when: "Show me details for torrent ID 5" -> params with ids=5
Use when: "Get info for torrents 1, 2, and 3" -> params with ids=[1, 2, 3]
Use when: "Show all torrent details" -> params with ids='all'
Error Handling:
Returns "No torrents found matching the specified IDs" if IDs don't exist
Returns error message if connection fails
Inputs: ids (required), response_format.
transmission_list_torrentsList All TorrentsARead-onlyIdempotent
List all torrents in Transmission with their current status and statistics.
This tool retrieves a list of all torrents with detailed information including download progress, speeds, ratios, and peer connections. Supports pagination for large torrent lists.
Args:
limit (number): Maximum torrents to return, between 1-100 (default: 20)
offset (number): Number of torrents to skip for pagination (default: 0)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For JSON format: { total: number, count: number, offset: number, torrents: [...], has_more: boolean, next_offset?: number } For Markdown format: Human-readable list with status, progress, speeds, and statistics
Examples:
Use when: "Show me all my torrents"
Use when: "List the next 50 torrents" -> params with limit=50, offset=50
Use when: "What's downloading right now?"
Error Handling:
Returns "No torrents found" if list is empty
Handles pagination automatically with has_more indicator
Inputs: limit, offset, response_format.
transmission_move_torrentMove Torrent to New LocationA
Move torrent data files to a new location on disk.
This tool relocates torrent files to a different directory. By default, it moves the files physically. Set move=false to just update the path if files are already at the new location.
Args:
ids (number | number[] | 'all'): Torrent ID(s) to move
location (string): Destination directory path
move (boolean): If true, move files; if false, just update location (default: true)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Confirmation that move operation was initiated
Examples:
Use when: "Move torrent 5 to /downloads/completed"
Use when: "Change location of all torrents to /media/storage" -> params with ids='all'
Use when: "Update path for torrent 3 (files already moved)" -> params with move=false
Error Handling:
Returns error if destination path doesn't exist
Returns error if insufficient permissions
Move operation may take time for large files
Inputs: ids (required), location (required), move, response_format.
transmission_pause_torrentPause TorrentAIdempotent
Pause active torrent(s) to stop downloading/uploading.
This tool pauses torrents, stopping all download and upload activity. Paused torrents can be resumed later without losing progress.
Args:
ids (number | number[] | 'all'): Torrent ID(s) to pause
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Confirmation message indicating which torrents were paused
Examples:
Use when: "Pause torrent 5"
Use when: "Pause all torrents" -> params with ids='all'
Don't use when: You want to remove a torrent (use transmission_remove_torrent instead)
Error Handling:
Returns error if torrent IDs don't exist
Succeeds even if torrents are already paused (idempotent)
Inputs: ids (required), response_format.
transmission_queue_moveMove Torrent in QueueA
Move torrent(s) to a different position in the download queue.
This tool reorders torrents in the download queue. Use this to prioritize certain downloads by moving them to the top or adjusting their position.
Args:
ids (number | number[] | 'all'): Torrent ID(s) to move
direction ('top' | 'up' | 'down' | 'bottom'): Where to move the torrent(s)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Confirmation of queue position change
Examples:
Use when: "Move torrent 5 to top of queue" -> params with direction='top'
Use when: "Move torrent 3 down in the queue" -> params with direction='down'
Use when: "Prioritize torrents 1 and 2" -> params with ids=[1, 2], direction='top'
Error Handling:
Returns error if torrent IDs don't exist
Moving to top/bottom is idempotent
Inputs: ids (required), direction (required), response_format.
transmission_reannounce_torrentReannounce Torrent to TrackersA
Force torrent(s) to reannounce to their trackers.
This tool forces an immediate announcement to trackers, which can help update peer lists or fix connection issues. Normally, Transmission announces automatically at regular intervals.
Args:
ids (number | number[] | 'all'): Torrent ID(s) to reannounce
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Confirmation that reannounce request was sent
Examples:
Use when: "Update tracker for torrent 5"
Use when: "Not getting any peers, force an announce"
Use when: "Reannounce all torrents" -> params with ids='all'
Error Handling:
Returns error if torrent IDs don't exist
Success doesn't guarantee tracker response (depends on tracker availability)
Inputs: ids (required), response_format.
transmission_remove_torrentRemove TorrentADestructiveIdempotent
Remove torrent(s) from Transmission, with optional deletion of downloaded files.
This tool removes torrents from the Transmission queue. By default, it only removes the torrent from the queue and keeps the downloaded files on disk. Set delete_local_data=true to also delete the files.
Args:
ids (number | number[] | 'all'): Torrent ID(s) to remove
delete_local_data (boolean): If true, delete downloaded files from disk (default: false)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Confirmation message indicating which torrents were removed
Examples:
Use when: "Remove torrent 5 but keep the files" -> params with ids=5, delete_local_data=false
Use when: "Delete torrent 3 and all its files" -> params with ids=3, delete_local_data=true
Use when: "Remove all torrents" -> params with ids='all'
Don't use when: You want to pause a torrent (use transmission_pause_torrent instead)
Error Handling:
Returns error if torrent IDs don't exist
Confirms successful removal with file deletion status
Inputs: ids (required), response_format, delete_local_data.
transmission_resume_torrentResume TorrentAIdempotent
Resume paused torrent(s) to restart downloading/uploading.
This tool resumes paused torrents, restarting download and upload activity from where they left off.
Args:
ids (number | number[] | 'all'): Torrent ID(s) to resume
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Confirmation message indicating which torrents were resumed
Examples:
Use when: "Resume torrent 5"
Use when: "Resume all torrents" -> params with ids='all'
Use when: "Start downloading again"
Error Handling:
Returns error if torrent IDs don't exist
Succeeds even if torrents are already active (idempotent)
Inputs: ids (required), response_format.
transmission_set_sessionUpdate Session ConfigurationAIdempotent
Update Transmission daemon configuration and settings.
This tool modifies the configuration of the Transmission daemon. You can update speed limits, download directory, seeding settings, and more.
Args:
alt_speed_down (number, optional): Alternative download speed limit in KB/s
alt_speed_up (number, optional): Alternative upload speed limit in KB/s
alt_speed_enabled (boolean, optional): Enable alternative speed limits
download_dir (string, optional): Default download directory
speed_limit_down (number, optional): Regular download speed limit in KB/s
speed_limit_down_enabled (boolean, optional): Enable download speed limit
speed_limit_up (number, optional): Regular upload speed limit in KB/s
speed_limit_up_enabled (boolean, optional): Enable upload speed limit
seedRatioLimit (number, optional): Global seed ratio limit
seedRatioLimited (boolean, optional): Enable global seed ratio limit
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Confirmation of updated settings
Examples:
Use when: "Set download speed limit to 1000 KB/s"
Use when: "Change download directory to /downloads"
Use when: "Enable alternative speed limits"
Error Handling:
Returns error if invalid settings provided
Changes take effect immediately
Inputs: alt_speed_up, download_dir, alt_speed_down, seedRatioLimit, +7 more.
transmission_set_torrentUpdate Torrent SettingsAIdempotent
Update settings for specific torrent(s) including labels, speed limits, and seed ratios.
This tool modifies torrent-specific settings. You can update labels, bandwidth priorities, speed limits, and seeding behavior.
Args:
ids (number | number[] | 'all'): Torrent ID(s) to update
labels (string[], optional): Labels to apply
bandwidthPriority (number, optional): Priority: -1 (low), 0 (normal), 1 (high)
downloadLimit (number, optional): Download speed limit in KB/s
downloadLimited (boolean, optional): Enable download speed limit
uploadLimit (number, optional): Upload speed limit in KB/s
uploadLimited (boolean, optional): Enable upload speed limit
seedRatioLimit (number, optional): Torrent-specific seed ratio limit
seedRatioMode (number, optional): 0 (use global), 1 (use torrent), 2 (unlimited)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Confirmation of updated settings
Examples:
Use when: "Set torrent 5 label to 'movies'"
Use when: "Limit download speed to 500 KB/s for torrent 3"
Use when: "Set high priority for torrents 1 and 2"
Error Handling:
Returns error if torrent IDs don't exist
Validates numeric ranges for limits and priorities
Inputs: ids (required), labels, uploadLimit, downloadLimit, +6 more.
transmission_verify_torrentVerify Torrent DataAIdempotent
Verify the integrity of downloaded torrent data.
This tool triggers a verification check of torrent files against their checksums. Use this to ensure downloaded data is correct and complete, or to recheck files after moving them.
Args:
ids (number | number[] | 'all'): Torrent ID(s) to verify
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Confirmation that verification has been started
Examples:
Use when: "Verify torrent 5"
Use when: "Check if my download is corrupted"
Use when: "Recheck all torrents" -> params with ids='all'
Error Handling:
Returns error if torrent IDs don't exist
Verification runs in background; check torrent status to see results
Inputs: ids (required), response_format.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Each tool has a clearly distinct purpose covering all core operations on torrents and session. No two tools overlap confusingly.
All tools use 'transmission_' prefix with a verb_noun pattern, except 'queue_move' which deviates slightly from the pattern, but overall consistency is high.
15 tools is well-scoped for a torrent client MCP server, covering all essential operations without excess.
The tool set provides complete lifecycle management for torrents (add, remove, pause, resume, verify, move, set/ get settings) and session configuration, leaving no obvious gaps.
Maintenance
Related MCP Connectors
MCP server for the FFmpeg Micro video transcoding API — create, monitor, download transcodes.
MCP server for manus documentation, generated by doc2mcp.
MCP server for tabletopsimulator documentation, generated by doc2mcp.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides tools for interacting with the Transmission BitTorrent client via natural language, enabling users to manage torrents, configure download settings, and monitor download activity.4MIT
- AlicenseBqualityCmaintenancePython wrapper & MCP server for transmission1943 PyPI6MIT
- AlicenseCqualityDmaintenanceMCP server for interacting with Tdarr, a distributed transcoding system. Provides 21 tools for monitoring workers, managing flows, and controlling transcoding libraries.1002MIT
- FlicenseNot gradedqualityDmaintenanceEnables controlling a Transmission torrent daemon, allowing adding, listing, controlling torrents and checking free space, with support for SOCKS5 proxy for remote access.-