Synology
💾 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
What is Synology?
Synology 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...
💾 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
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
Maintainer
Works with
Installation
Manual Installation
npx synology-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Synology
The Synology MCP Server exposes your Synology NAS file system, Download Station, and system health monitoring to any MCP-compatible AI assistant through a secure REST API integration. It provides tools for listing directories, creating and moving files, managing download tasks, and querying disk health and system utilization — all without manually logging into the NAS web interface. The server supports both local Python execution and Docker deployment, with auto-authentication on startup, making it practical for teams that want to delegate routine NAS management to an AI assistant.
Prerequisites
- A Synology NAS running DSM 6.x or later with the FileStation and Download Station packages installed
- A dedicated NAS user account with appropriate permissions (2FA must be disabled for this account)
- Python 3.8 or later (for local run) or Docker and Docker Compose (for container deployment)
- Git to clone the repository
- An MCP-compatible client such as Claude Desktop or Cursor
Clone the repository
Download the server source code to your machine or the host that will run the server.
git clone https://github.com/atom2ueki/mcp-server-synology.git
cd mcp-server-synologyCreate and populate the .env file
Copy the provided example environment file and fill in your NAS address and credentials.
cp env.example .env
# Edit .env with your values:
# SYNOLOGY_URL=http://192.168.1.100:5000
# SYNOLOGY_USERNAME=your_nas_user
# SYNOLOGY_PASSWORD=your_nas_password
# AUTO_LOGIN=true
# VERIFY_SSL=falseStart with Docker (recommended)
Docker Compose starts the server in the background with all dependencies bundled. No Python installation required on the host.
docker-compose up -dOr run locally with Python
If you prefer to run without Docker, install Python dependencies and start the server directly.
pip install -r requirements.txt
python main.pyConfigure your MCP client
Add the server entry to your MCP client config. The server communicates over stdio when launched locally.
{
"mcpServers": {
"synology": {
"command": "python",
"args": ["/path/to/mcp-server-synology/main.py"],
"env": {
"SYNOLOGY_URL": "http://192.168.1.100:5000",
"SYNOLOGY_USERNAME": "nas_user",
"SYNOLOGY_PASSWORD": "nas_password",
"AUTO_LOGIN": "true",
"VERIFY_SSL": "false"
}
}
}
}Synology Examples
Client configuration
Full JSON config block for connecting Claude Desktop to the Synology MCP server running locally.
{
"mcpServers": {
"synology": {
"command": "python",
"args": ["/path/to/mcp-server-synology/main.py"],
"env": {
"SYNOLOGY_URL": "http://192.168.1.100:5000",
"SYNOLOGY_USERNAME": "nas_user",
"SYNOLOGY_PASSWORD": "nas_password",
"AUTO_LOGIN": "true",
"VERIFY_SSL": "false"
}
}
}
}Prompts to try
Example prompts covering file operations, downloads, and system health.
- "List all PDF files in /volume1/documents"
- "Create a download task for this torrent URL and save it to /volume1/downloads"
- "Show me the disk health and temperature for all drives"
- "Move /volume1/temp/report.xlsx to /volume1/archive/2024/"
- "What is the current CPU and memory utilization of my NAS?"
- "Search for files named 'invoice' anywhere under /volume1"Troubleshooting Synology
Authentication fails with 'incorrect credentials' even though the password is correct
Two-factor authentication cannot be used with this server. Create a separate NAS account with 2FA disabled, and use those credentials in SYNOLOGY_USERNAME and SYNOLOGY_PASSWORD.
SSL errors when connecting to the NAS
If your NAS uses a self-signed certificate, set VERIFY_SSL=false in your .env file. For production environments with a valid certificate, set VERIFY_SSL=true.
Download Station tools return 'service not available'
Ensure the Download Station package is installed and enabled on your Synology NAS via the Package Center. The NAS user account must also have Download Station permissions.
Frequently Asked Questions about Synology
What is Synology?
Synology 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?
Follow the installation instructions on the Synology GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Synology?
Synology works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Synology free to use?
Yes, Synology is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Synology Alternatives — Similar File Systems Servers
Looking for alternatives to Synology? 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.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An 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
★ 801A 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
★ 723Enables 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
★ 643Provides 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.
Set Up Synology in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Synology?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.