Log inSubmit server
Synology NAS logo

Synology NAS

Connects MCP clients to Synology DSM for file operations, NAS monitoring, and optional Download Station control.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Synology NAS

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "synology-nas": {
      "command": "uvx",
      "args": [
        "mcp-synology"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Synology NAS MCP server exposes Synology DSM API functions as MCP tools for Claude and other MCP clients. It supports File Station browsing and file management, read-only system and resource monitoring, and optional Download Station queue and settings control. Reach for it when an agent needs to inspect or operate files on a Synology NAS, check NAS status, or manage downloads; it has been tested with DSM 7.1, 7.2.2, 7.3.2, and 7.4.1.

Use cases

  • Browse and manage files on a Synology NAS
  • Monitor NAS health and live resource usage
  • Search shared folders from an MCP client
  • Manage Download Station tasks and schedules
  • Transfer files between a local client and the NAS

Key features

  • File Station browsing, search, transfer, and management
  • NAS system information and resource monitoring
  • Optional Download Station queue and settings control
  • Read and write permission tiers
  • Multi-NAS configuration support
  • Configuration validation and login checks

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

5/5 checks healthy over the last 42d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · mcp-synology (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars12Stargazers on the source repository.
Last commit2d agoMost recent push to the default branch.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Synology NAS works

What Synology NAS does

The Synology NAS MCP server connects an MCP client to a Synology NAS through the DSM API. Its tools cover three areas: File Station, System, and Download Station. File Station provides file and shared-folder operations, System reports NAS information and current resource use, and Download Station manages download tasks when that module is enabled.

File Station includes read and write permission tiers. Read operations can list shares and files, search, inspect file details, calculate directory size, view the recycle bin, and download files. Write operations can create folders, rename, copy, move, delete, restore recycle-bin items, upload files, and handle file tasks.

The System module provides model, firmware version, memory, temperature, uptime, CPU, memory, disk I/O, and network information. Basic system information is available to all users; resource usage requires an administrator account.

How it works

The Synology NAS MCP server translates MCP tool calls into requests to DSM. Access is governed by the configured module and permission level, along with the Synology account used by the server. File Station and System are available through the standard setup path, while Download Station is opt-in.

Download Station exposes read tools for listing downloads, retrieving task details and statistics, viewing configuration, and checking the schedule. Write tools can create, delete, pause, resume, and edit downloads, change download configuration, and set the schedule. The Download Station package must be installed on the NAS before these calls can succeed.

Setup and configuration

The package provides an mcp-synology setup command that configures File Station. Configuration is stored under ~/.config/mcp-synology/config.yaml, or in a per-NAS file when Multi-NAS configuration is used. The mcp-synology check --config <file> command validates YAML and configuration values and checks whether login still works.

To enable Download Station, add its module under the existing modules: section and choose permission: read or permission: write. Restart the MCP client after changing configuration because the server reads its configuration only at startup.

Torrent and NZB uploads use a local file path. By default, local files must come from the Downloads folder. Additional permitted folders can be configured with allowed_local_paths.

Tools and capabilities

  • Browse shares, directories, and files.
  • Search files and inspect file metadata or directory size.
  • Upload, download, copy, move, rename, delete, and restore files.
  • Read NAS identity, firmware, temperature, uptime, and memory details.
  • Read live CPU, memory, disk, and network usage with an administrator account.
  • Manage Download Station tasks, settings, and schedules when enabled.

Limitations and notes

A folder download is saved as DSM's ZIP archive, using the folder name or a supplied filename. Downloading an entire shared folder is refused because DSM does not provide it as a single download.

Non-admin Download Station users need the application privilege in DSM. They can view and manage only their own tasks, change their own default destination, and cannot change NAS-wide speed limits. An administrator is required for weekly schedules and limited-speed rates, although non-admin users can still toggle the schedule.

A Download Station user may need to set a default destination before tasks can start. The set_download_config tool can set that destination for the user. A task created with an explicit destination may be accepted but warned that it will not start until the required setup is complete.

The repository documents testing against DSM 7.1, 7.2.2, 7.3.2, and 7.4.1. Users upgrading from the older synology-mcp package can use the provided migration script to move configuration, state, keyring credentials, and Claude Desktop settings.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Synology NAS

Synology NAS is an MCP server that connects MCP clients to Synology DSM and exposes File Station, System, and optional Download Station tools. It supports file browsing and management, NAS health and resource monitoring, and download task control when Download Station is installed and enabled.

Install the package and run its setup command to configure File Station, then add the generated configuration to your MCP client. Configuration is stored under `~/.config/mcp-synology/`; run `mcp-synology check --config <file>` to validate it and test login access.

Add `downloadstation` under the existing `modules:` section in the configuration, set `enabled: true`, and choose `permission: read` or `permission: write`. Install Download Station on the NAS first, validate the configuration, and restart the MCP client.

Yes, but non-admin access has restrictions. Resource usage requires an administrator, while Download Station users need its application privilege and can manage only their own tasks; NAS-wide speed limits and weekly schedule rates require an administrator.

Related MCP servers

All in File Systems All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSynology NAS AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/synology-nas?style=directory)](https://allmcps.com/mcp/synology-nas)
HTML Embed
<a href="https://allmcps.com/mcp/synology-nas"><img src="https://allmcps.com/api/badge/synology-nas?style=directory" alt="Synology NAS on AllMCPs" /></a>