Synology Download Station MCP

An MCP server for controlling Synology Download Station. Manage download tasks on your NAS through the official DSM Web API: list / inspect / create / pause / resume / delete tasks, and view real-time transfer statistics.

Runs over stdio and works with any MCP-capable client (such as Claude Desktop).

Requirements

• Node.js 20+
• A Synology NAS with the Download Station package installed and enabled
• A DSM account that has permission to use Download Station

Quick start

Update your mcp setting in your favourite tool:

{
  "mcpServers": {
    "dsm-download-station": {
      "command": "npx",
      "args": [
        "-y",
        "@lancercomet/synology-ds-mcp"
      ],
      "env": {
        "DS_BASE_URL": "http://192.168.1.10:5000",
        "DS_ACCOUNT": "your-account",
        "DS_PASSWORD": "your-password"
      }
    }
  }
}

Configuration

| Variable | Required | Default | Description | | --- | --- | --- | --- | | DS_BASE_URL | ✅ | — | DSM address including protocol, IP, and port. HTTP defaults to 5000, HTTPS to 5001. Example: http://192.168.1.10:5000 | | DS_ACCOUNT | ✅ | — | DSM account | | DS_PASSWORD | ✅ | — | DSM password | | DS_DEFAULT_DESTINATION | ❌ | NAS default | Default download directory for new tasks. Starts with a shared folder, no leading /. Example: Downloads | | DS_INSECURE_TLS | ❌ | false | Set to true to skip certificate verification when the NAS uses a self-signed HTTPS certificate (accepts true / 1) | | DS_TIMEOUT_MS | ❌ | 15000 | Per-request timeout (milliseconds) | | DS_OTP_CODE | ❌ | — | Two-factor verification code (usually not needed for Download Station) |

Tips

Instead of your DSM admin account, create a dedicated user for this server, grant it access only to the Download Station application (and the shared folders used for downloads), and disable 2-factor authentication (2FA) for it.

Available MCP Tools

| Tool | Description | Parameters | | --- | --- | --- | | list_tasks | List download tasks | offset? limit? detail? | | get_task | Get details and transfer info for specific tasks | ids (required) | | create_task | Create a download task | uri (required) destination? username? password? | | pause_task | Pause tasks | ids (required) | | resume_task | Resume tasks | ids (required) | | delete_task | Delete tasks | ids (required) force_complete? | | get_statistics | Get global download/upload speed statistics | none |

Notes

• Ports: HTTP defaults to 5000, HTTPS to 5001; make sure DS_BASE_URL matches your actual setup.
• Self-signed certificates: When accessing over HTTPS with a self-signed certificate, set DS_INSECURE_TLS=true to skip verification (applies only to this server's requests, not globally).
• Download directory format: destination / DS_DEFAULT_DESTINATION must start with a shared folder and have no leading /, e.g. Downloads, Downloads/movies.
• Session: The server uses lazy login, connecting to the NAS only on the first tool call; on session timeout it automatically re-logs in and retries once.
• Version negotiation: API paths and versions are negotiated automatically via SYNO.API.Info; no manual specification needed.