
Synology MCP
Active Backup for Business jobs and storage health from every client Synology NAS, in…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.1.5
- Listing updated
- 4 days ago
About Synology MCP
Synology MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Active Backup for Business jobs and storage health from every client Synology NAS, in one database
Install
Run in a 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.mcpbAdd to claude_desktop_config.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>"
}
}
}
}Add to ~/.cursor/mcp.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>"
}
}
}
}Add to .vscode/mcp.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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Configuration
SYNOLOGY_BASE_URLDSM address of the NAS with scheme and port, for example https://nas.acme.example:5001.RequiredSYNOLOGY_ACCOUNTDSM account name used for the SYNO.API.Auth login.RequiredSYNOLOGY_PASSWORDDSM account password; sent only in the login request, never written to disk.RequiredSYNOLOGY_DEVICE_IDOptional. Trusted-device token from an earlier two-factor login, used instead of a one-time code.SYNOLOGY_OTP_CODEOptional. One-time code for the first login of a two-factor account.SYNOLOGY_TLS_FINGERPRINTOptional. SHA-256 fingerprint of the NAS certificate to pin (DSM ships a self-signed certificate).SYNOLOGY_SKIP_TLS_VERIFYOptional. Set to 1 to skip certificate verification; prefer SYNOLOGY_TLS_FINGERPRINT.SYNOLOGY_MCP_READ_ONLYOptional. Blank, 0, false, no or off keeps every tool; any other value removes every write tool.SYNOLOGY_MCP_HTTP_TOKENBearer token of at least 32 characters that callers must present when the server runs with --transport http; not used by stdio.SYNOLOGY_USER_AGENTOptional. Overrides the User-Agent header the CLI sends to the NAS.SYNOLOGY_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of NAS answers: reads go to the NAS live, the response cache is off, and sync and fleet sync refuse to run (so the fleet reports have no mirror to read). Leave blank to keep the local store.PRINTING_PRESS_CLIENT_PROFILENot used by this connector (no tenant-gated client profiles); leave unset.
Pricing
Open source
Synology MCP 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