How do I install Synology NAS MCP Server?

Follow the setup instructions on the Synology NAS GitHub repository, then add the server configuration to your AI client.

What category is Synology NAS MCP Server?

Synology NAS is categorized under File Systems. Browse more servers in these categories on MCPgee.

Synology NAS

Name: Synology MCP Server
Author: atom2ueki

v1.0.0•File Systems•stable

💾 Model Context Protocol (MCP) server for Synology NAS - Enables AI assistants (Claude, Cursor, Continue) to manage files, downloads, and system operations through secure API integration. Features Docker deployment, auto-authentication, and comprehen

mcpmcp-serversynology

101

Stars

Downloads

Weekly

0/5

View on GitHub

What is Synology NAS?

Synology NAS is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 💾 model context protocol (mcp) server for synology nas - enables ai assistants (claude, cursor, continue) to manage files, downloads, and system operations through secure api integration. features do...

This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

💾 Model Context Protocol (MCP) server for Synology NAS - Ena

Use Cases

Manage Synology NAS files and operations through AI assistants. Download files and control system settings securely.

atom2ueki

Maintainer

LicenseMIT

Languagepython

Versionv1.0.0

UpdatedMay 17, 2026

Statushealthy

Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

View Source Browse All Servers

Installation

Manual Installation

npx synology

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms

ThroughputMedium

Resource Usage

Memory UsageLow

CPU UsageLow

How to Set Up and Use Synology NAS

The Synology MCP Server is a Python-based bridge that lets AI assistants such as Claude, Cursor, and Continue directly manage a Synology NAS through its DSM web API. It covers file operations (list, create, move, rename, delete), Download Station task management (add URLs and magnet links, pause/resume), and system health monitoring (CPU, memory, disk SMART, network, UPS, and service status) — all through natural language without needing to open the Synology web interface.

Prerequisites

A Synology NAS running DSM with the File Station and Download Station packages enabled
Docker and Docker Compose installed on the machine running the MCP server, or Python 3.10+
A dedicated Synology account (without two-factor authentication) for API access
The NAS URL (e.g., http://192.168.1.100:5000), username, and password
An MCP-compatible client such as Claude Desktop, Cursor, or Continue

Clone the repository

Clone the mcp-server-synology repository to the machine that will run the MCP server. This can be your local machine or a Docker host.

git clone https://github.com/atom2ueki/mcp-server-synology.git
cd mcp-server-synology

Configure environment variables

Copy the example environment file and fill in your NAS connection details. The SYNOLOGY_URL must be reachable from the server running the MCP process.

cp env.example .env
# Edit .env and set:
# SYNOLOGY_URL=http://192.168.1.100:5000
# SYNOLOGY_USERNAME=your_nas_user
# SYNOLOGY_PASSWORD=your_nas_password
# AUTO_LOGIN=true
# VERIFY_SSL=false

Start the server with Docker Compose

Build and start the container. The MCP server will launch and authenticate against your NAS automatically if AUTO_LOGIN is set to true.

docker-compose up -d --build

Configure Claude Desktop

Add the synology server to your claude_desktop_config.json, pointing to the docker-compose file. Adjust the path to match where you cloned the repository.

{
  "mcpServers": {
    "synology": {
      "command": "docker-compose",
      "args": ["-f", "/path/to/mcp-server-synology/docker-compose.yml", "run", "--rm", "synology-mcp"],
      "cwd": "/path/to/mcp-server-synology"
    }
  }
}

Verify connection and try file operations

Restart Claude Desktop and ask it to list files on your NAS or check system health. The server reads credentials from the .env file and connects to your NAS on each request.

Synology NAS Examples

Client configuration

Claude Desktop configuration for the Synology MCP Server using Docker Compose.

{
  "mcpServers": {
    "synology": {
      "command": "docker-compose",
      "args": ["-f", "/path/to/mcp-server-synology/docker-compose.yml", "run", "--rm", "synology-mcp"],
      "cwd": "/path/to/mcp-server-synology"
    }
  }
}

Prompts to try

Example prompts for managing your Synology NAS through Claude.

- "List all files in /volume1/documents and show their sizes"
- "Add this torrent magnet link to Download Station and save to /volume1/downloads"
- "Check the CPU and memory usage on my NAS right now"
- "Create a folder called 'Projects/2026' in /volume1/shared and move all .zip files there"
- "Show me the SMART health status of all disks on the NAS"

Troubleshooting Synology NAS

Authentication fails with 'Invalid username or password'

Ensure the Synology account does not have two-factor authentication enabled — the API does not support 2FA. Verify SYNOLOGY_URL is reachable from the Docker container (not localhost if NAS is on a different host). Check that the DSM user has File Station and Download Station permissions.

SSL certificate errors when VERIFY_SSL is true

Synology NAS units often use self-signed certificates. Set VERIFY_SSL=false in your .env file for home network setups, or install a valid certificate in DSM under Control Panel > Security > Certificate.

Docker Compose command not found in Claude Desktop

Claude Desktop may not inherit your shell PATH. Use the absolute path to docker-compose in the command field, e.g., /usr/local/bin/docker-compose. Run which docker-compose in a terminal to find the full path.

Frequently Asked Questions about Synology NAS

What is Synology NAS?

Synology NAS is a Model Context Protocol (MCP) server that 💾 model context protocol (mcp) server for synology nas - enables ai assistants (claude, cursor, continue) to manage files, downloads, and system operations through secure api integration. features docker deployment, auto-authentication, and comprehen It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Synology NAS?

Follow the installation instructions on the Synology NAS GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Synology NAS?

Synology NAS works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Synology NAS free to use?

Yes, Synology NAS is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Synology NAS Alternatives — Similar File Systems Servers

Looking for alternatives to Synology NAS? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.

Electerm

★ 14.1k

📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)

Plik

★ 1.8k

Plik is a temporary file upload system (Wetransfer like) in Go.

Kordoc

★ 957

An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.

macOS Automator

★ 801

A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.

PDF Reader

★ 723

Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.

Filesystem MCP Server

★ 643

Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.

Browse More File Systems MCP Servers

Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

File Systems Browse All Servers

Set Up Synology NAS in Your Editor

Choose your AI client for step-by-step setup instructions.

🖥️

Claude Desktop

macOS & Windows app

⌨️

Claude Code

CLI & terminal

📝

Cursor

AI-first code editor

💻

VS Code

GitHub Copilot MCP

🏄

Windsurf

Codeium AI editor

🔌

Cline

VS Code extension

Quick Config Preview

{
  "mcpServers": {
    "synology": {
      "command": "npx",
      "args": ["-y", "synology"]
    }
  }
}

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Synology NAS?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides

Explore All Servers Read Our Guides