Skip to main content
Glama
transmission-mcp

transmission-mcp

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 build

Configuration

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 start

Available Tools

Torrent Management

  • transmission_add_torrent - Add torrent from magnet URI, URL, or base64-encoded .torrent file

  • transmission_list_torrents - List all torrents with optional filtering

  • transmission_get_torrent - Get detailed information about specific torrent(s)

  • transmission_remove_torrent - Remove torrent with option to delete local files

  • transmission_pause_torrent - Pause active torrent(s)

  • transmission_resume_torrent - Resume paused torrent(s)

  • transmission_verify_torrent - Verify torrent data integrity

  • transmission_reannounce_torrent - Force tracker reannounce

  • transmission_move_torrent - Move torrent to new location

  • transmission_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 configuration

  • transmission_set_session - Update daemon settings

  • transmission_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 clean

License

MIT

Available Tools

15 tools
transmission_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 SpaceA
Read-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 ConfigurationA
Read-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 StatisticsA
Read-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 DetailsA
Read-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 TorrentsA
Read-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 TorrentA
Idempotent

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 TorrentA
DestructiveIdempotent

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 TorrentA
Idempotent

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 ConfigurationA
Idempotent

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 SettingsA
Idempotent

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 DataA
Idempotent

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

    A4.4/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose covering all core operations on torrents and session. No two tools overlap confusingly.

    Naming Consistency4/5

    All tools use 'transmission_' prefix with a verb_noun pattern, except 'queue_move' which deviates slightly from the pattern, but overall consistency is high.

    Tool Count5/5

    15 tools is well-scoped for a torrent client MCP server, covering all essential operations without excess.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides tools for interacting with the Transmission BitTorrent client via natural language, enabling users to manage torrents, configure download settings, and monitor download activity.
      4
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      MCP server for interacting with Tdarr, a distributed transcoding system. Provides 21 tools for monitoring workers, managing flows, and controlling transcoding libraries.
      100
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables controlling a Transmission torrent daemon, allowing adding, listing, controlling torrents and checking free space, with support for SOCKS5 proxy for remote access.
      -