syno-workspace-mcp
Provides tools for interacting with Synology Drive and Synology Spreadsheet on a Synology NAS, enabling file operations (listing, moving, renaming, deleting) and spreadsheet operations (listing, reading sheets with formulas or results, creating and registering spreadsheets).
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
syno-workspace-mcp
MCP server for Synology Drive and Synology Spreadsheet, built with FastMCP. Python port of vocweb/synology-mcp-server.
Status: milestone 4 (Spreadsheet). The 11 Drive and 15 Spreadsheet tools are available. Tools that overwrite, rename or delete do nothing unless called with
confirm: true.
How it runs
Streamable HTTP transport on
/mcp, listening on loopback (127.0.0.1:3100).The DSM reverse proxy terminates HTTPS and forwards to it.
Clients authenticate with a static bearer token (
MCP_AUTH_TOKEN).GET /healthis unauthenticated and only returns{"status": "ok"}.Host header validation: only loopback and
MCP_ALLOWED_HOSTSare accepted (other hosts get421); browser requests from foreign origins get403.
Related MCP server: MCP Filesystem Server
Install on a Synology NAS
Requires Container Manager (Docker) and SSH access.
mkdir -p /volume1/docker/syno-workspace-mcp && cd /volume1/docker/syno-workspace-mcp
curl -fsSLO https://raw.githubusercontent.com/alexcane/syno-workspace-mcp/main/deploy/docker-compose.yml
curl -fsSL -o .env https://raw.githubusercontent.com/alexcane/syno-workspace-mcp/main/deploy/.env.example
vi .env # fill in DSM URL, account, secrets (openssl rand -hex 32), allowed hosts
mkdir -p data && sudo chown 1000:1000 data
sudo docker compose pull && sudo docker compose up -d
curl -fsS http://127.0.0.1:3100/healthThen add a DSM reverse proxy rule (HTTPS → http://localhost:3100, read timeout
3600 s) and connect a client:
claude mcp add --scope user --transport http synology https://<host>:<port>/mcp \
--header "Authorization: Bearer <MCP_AUTH_TOKEN>"Spreadsheet tools
Spreadsheet tools go through the synology/spreadsheet-api container (started by
the same compose file), which logs in to DSM itself at SYNO_SS_DSM_URL.
The DSM account needs the Synology Office application privilege in addition to Synology Drive.
A spreadsheet is addressed by its Spreadsheet ID (
file_id): the letters and digits after/oo/r/in the Office URL, also listed byspreadsheet_list. The full URL is accepted, Drive file IDs are not. The Drivepathof the.osheetworks too, and so does anamestored withspreadsheet_register(kept inDATA_DIR;spreadsheet_createregisters the files it creates).spreadsheet_read_sheetreturns formula results;include_formulas: truereturns the formulas as typed. Dates are serial day numbers.spreadsheet_createcannot pick a folder: the Spreadsheet API decides where the file goes; move it withdrive_move_file.
Configuration
All configuration comes from environment variables, validated at startup; see
deploy/.env.example. An invalid or missing variable stops
the server with a message naming it.
Development
Requires uv.
uv sync
uv run ruff check . && uv run ruff format --check .
uv run mypy
uv run pytest --covRun locally over stdio (for MCP Inspector or a desktop client):
uv run python -m syno_workspace_mcp --transport stdiotests/smoke/ holds tests against a real NAS; they are excluded from the default
run and launched by hand.
Releases
Pushing a tag vX.Y.Z matching version in pyproject.toml builds the
linux/amd64 image and publishes ghcr.io/alexcane/syno-workspace-mcp:X.Y.Z.
No latest tag is published.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Browse and manage files in your Moxt AI workspace from any MCP client.
Hosted remote MCP for protected account access, permissions, activity history and supported undo.
Manage files and folders directly from your workspace. Read and write files, list directories, cre…
Online office suite for AI agents: edit docs, sheets, slides and PDFs in browser or via MCP.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables comprehensive Google Drive integration through MCP, supporting file management, content operations, permission handling, commenting, version control, and shared drive management through natural language interactions.-
- AlicenseNot gradedqualityDmaintenanceEnables file system operations such as listing directories, reading, writing, creating, and deleting files or directories through MCP.21 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables management of Google Drive files, Docs, Sheets, and Slides through natural language using MCP, with support for file operations, search, and shared drives.10 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Synology NAS services including DSM, File Station, Calendar, Note Station, Contacts, Chat, Download Station, and Container Manager through a modular MCP interface with configurable safety modes.MIT