# Synology MCP

> Synology MCP is an open-source MCP server. Active Backup for Business jobs and storage health from every client Synology NAS, in one database. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/servosity/msp-skills/tree/HEAD/skills/synology
- **MCP Registry name:** io.github.Servosity/synology-mcp
- **Listing updated:** 2026-11-13

## About

Active Backup for Business jobs and storage health from every client Synology NAS, in one database

## Install

### Claude Code (Terminal)

```sh
claude mcp add synology-mcp --env SYNOLOGY_BASE_URL='<SYNOLOGY_BASE_URL>' --env SYNOLOGY_ACCOUNT='<SYNOLOGY_ACCOUNT>' --env SYNOLOGY_PASSWORD='<SYNOLOGY_PASSWORD>' --env SYNOLOGY_DEVICE_ID='<SYNOLOGY_DEVICE_ID>' --env SYNOLOGY_OTP_CODE='<SYNOLOGY_OTP_CODE>' --env SYNOLOGY_MCP_HTTP_TOKEN='<SYNOLOGY_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/synology-v0.1.5/synology-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "synology-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/synology-v0.1.5/synology-mcp.mcpb"
      ],
      "env": {
        "SYNOLOGY_BASE_URL": "<SYNOLOGY_BASE_URL>",
        "SYNOLOGY_ACCOUNT": "<SYNOLOGY_ACCOUNT>",
        "SYNOLOGY_PASSWORD": "<SYNOLOGY_PASSWORD>",
        "SYNOLOGY_DEVICE_ID": "<SYNOLOGY_DEVICE_ID>",
        "SYNOLOGY_OTP_CODE": "<SYNOLOGY_OTP_CODE>",
        "SYNOLOGY_MCP_HTTP_TOKEN": "<SYNOLOGY_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "synology-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/synology-v0.1.5/synology-mcp.mcpb"
      ],
      "env": {
        "SYNOLOGY_BASE_URL": "<SYNOLOGY_BASE_URL>",
        "SYNOLOGY_ACCOUNT": "<SYNOLOGY_ACCOUNT>",
        "SYNOLOGY_PASSWORD": "<SYNOLOGY_PASSWORD>",
        "SYNOLOGY_DEVICE_ID": "<SYNOLOGY_DEVICE_ID>",
        "SYNOLOGY_OTP_CODE": "<SYNOLOGY_OTP_CODE>",
        "SYNOLOGY_MCP_HTTP_TOKEN": "<SYNOLOGY_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "synology-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/synology-v0.1.5/synology-mcp.mcpb"
      ],
      "env": {
        "SYNOLOGY_BASE_URL": "<SYNOLOGY_BASE_URL>",
        "SYNOLOGY_ACCOUNT": "<SYNOLOGY_ACCOUNT>",
        "SYNOLOGY_PASSWORD": "<SYNOLOGY_PASSWORD>",
        "SYNOLOGY_DEVICE_ID": "<SYNOLOGY_DEVICE_ID>",
        "SYNOLOGY_OTP_CODE": "<SYNOLOGY_OTP_CODE>",
        "SYNOLOGY_MCP_HTTP_TOKEN": "<SYNOLOGY_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "synology-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/synology-v0.1.5/synology-mcp.mcpb"
      ],
      "env": {
        "SYNOLOGY_BASE_URL": "<SYNOLOGY_BASE_URL>",
        "SYNOLOGY_ACCOUNT": "<SYNOLOGY_ACCOUNT>",
        "SYNOLOGY_PASSWORD": "<SYNOLOGY_PASSWORD>",
        "SYNOLOGY_DEVICE_ID": "<SYNOLOGY_DEVICE_ID>",
        "SYNOLOGY_OTP_CODE": "<SYNOLOGY_OTP_CODE>",
        "SYNOLOGY_MCP_HTTP_TOKEN": "<SYNOLOGY_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "synology-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/synology-v0.1.5/synology-mcp.mcpb"
      ],
      "env": {
        "SYNOLOGY_BASE_URL": "<SYNOLOGY_BASE_URL>",
        "SYNOLOGY_ACCOUNT": "<SYNOLOGY_ACCOUNT>",
        "SYNOLOGY_PASSWORD": "<SYNOLOGY_PASSWORD>",
        "SYNOLOGY_DEVICE_ID": "<SYNOLOGY_DEVICE_ID>",
        "SYNOLOGY_OTP_CODE": "<SYNOLOGY_OTP_CODE>",
        "SYNOLOGY_MCP_HTTP_TOKEN": "<SYNOLOGY_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Is Synology MCP free?

Yes. Synology MCP is open source, so you can use and self-host it for free.

### How do I add Synology MCP to Claude Code?

Run this command in your terminal: claude mcp add synology-mcp --env SYNOLOGY_BASE_URL='<SYNOLOGY_BASE_URL>' --env SYNOLOGY_ACCOUNT='<SYNOLOGY_ACCOUNT>' --env SYNOLOGY_PASSWORD='<SYNOLOGY_PASSWORD>' --env SYNOLOGY_DEVICE_ID='<SYNOLOGY_DEVICE_ID>' --env SYNOLOGY_OTP_CODE='<SYNOLOGY_OTP_CODE>' --env SYNOLOGY_MCP_HTTP_TOKEN='<SYNOLOGY_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/synology-v0.1.5/synology-mcp.mcpb

---
Source: https://ai-powered.com/mcp/synology-mcp
