mcp-synology-nas

MCP server that exposes your Synology NAS (DSM 7.x) to Claude Code and Cowork via the Model Context Protocol. Built with FastMCP and the synology-api Python library.

• List shared folders and browse directories
• Search files by name, pattern, or extension
• Create, rename, and delete files/folders
• Copy and move files between locations
• Upload files from local machine to NAS
• Generate file trees for folder overview
• Create shareable links (with optional password/expiry)

• DSM version and system info
• CPU temperature and utilization
• Memory, disk, and network utilization
• Storage pool/volume status and capacity
• Disk health (SMART status)
• Installed packages
• Active connections and recent logs

• List, create, pause, resume, delete download tasks
• Supports HTTP, FTP, magnet links, torrents
• Transfer statistics

• Python 3.10+
• Synology NAS running DSM 7.x
• A DSM user account with appropriate permissions

# Clone or copy the server files
cd synology-mcp

# Install dependencies
pip install synology-api mcp[cli] httpx pydantic

# Copy and edit environment config
cp .env.example .env
# Edit .env with your NAS details

This server reads your DSM password from macOS Keychain — no passwords in code or config files.

# Store your DSM password
security add-generic-password -a "your_username" -s "synology-mcp" -w "your_password"

# To update an existing password
security add-generic-password -a "your_username" -s "synology-mcp" -w "new_password" -U

Add to your Claude Code MCP config (project-level .mcp.json or ~/.claude.json):

{
  "mcpServers": {
    "synology": {
      "command": "python",
      "args": ["/path/to/synology-mcp/server.py"],
      "env": {
        "SYNO