Synology Chat
Read Synology Chat channels, find users and send messages or files through your own NAS
- Pricing
- Open source
- Platforms
- CLI, self-hosted, Linux
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
- today
Similar MCP servers
About Synology Chat
Synology Chat is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
This server signs in to a self-hosted Synology Chat instance as an ordinary DSM user through the Synology Web API, so it sees exactly the channels and direct messages that user sees. No bot or webhook setup is needed. Direct messages appear with the type anonymous, which is Synology's name for one-to-one conversations.
Six tools cover listing joined channels with unread counts, finding users by part of a username, reading recent posts, looking up the DM channel for a user, posting text and uploading a local file with an optional message. Configuration is through environment variables for the server URL, username, password and an option to skip certificate checks for self-signed setups.
Limits to know about: accounts with two-factor authentication are not supported, user search matches usernames only, and downloading attachments is not yet a tool. It can run through uvx from GitHub or from a Docker image, and is MIT licensed.
Install
Run in a terminal
claude mcp add synology-chat-mcp --env SYNOLOGY_CHAT_URL='<SYNOLOGY_CHAT_URL>' --env SYNOLOGY_CHAT_USER='<SYNOLOGY_CHAT_USER>' --env SYNOLOGY_CHAT_PASS='<SYNOLOGY_CHAT_PASS>' -- docker run -i --rm -e SYNOLOGY_CHAT_URL -e SYNOLOGY_CHAT_USER -e SYNOLOGY_CHAT_PASS ghcr.io/louis-lastella/synology-chat-mcp:0.2.0Add to claude_desktop_config.json
{
"mcpServers": {
"synology-chat-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SYNOLOGY_CHAT_URL",
"-e",
"SYNOLOGY_CHAT_USER",
"-e",
"SYNOLOGY_CHAT_PASS",
"ghcr.io/louis-lastella/synology-chat-mcp:0.2.0"
],
"env": {
"SYNOLOGY_CHAT_URL": "<SYNOLOGY_CHAT_URL>",
"SYNOLOGY_CHAT_USER": "<SYNOLOGY_CHAT_USER>",
"SYNOLOGY_CHAT_PASS": "<SYNOLOGY_CHAT_PASS>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"synology-chat-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SYNOLOGY_CHAT_URL",
"-e",
"SYNOLOGY_CHAT_USER",
"-e",
"SYNOLOGY_CHAT_PASS",
"ghcr.io/louis-lastella/synology-chat-mcp:0.2.0"
],
"env": {
"SYNOLOGY_CHAT_URL": "<SYNOLOGY_CHAT_URL>",
"SYNOLOGY_CHAT_USER": "<SYNOLOGY_CHAT_USER>",
"SYNOLOGY_CHAT_PASS": "<SYNOLOGY_CHAT_PASS>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"synology-chat-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SYNOLOGY_CHAT_URL",
"-e",
"SYNOLOGY_CHAT_USER",
"-e",
"SYNOLOGY_CHAT_PASS",
"ghcr.io/louis-lastella/synology-chat-mcp:0.2.0"
],
"env": {
"SYNOLOGY_CHAT_URL": "<SYNOLOGY_CHAT_URL>",
"SYNOLOGY_CHAT_USER": "<SYNOLOGY_CHAT_USER>",
"SYNOLOGY_CHAT_PASS": "<SYNOLOGY_CHAT_PASS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"synology-chat-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SYNOLOGY_CHAT_URL",
"-e",
"SYNOLOGY_CHAT_USER",
"-e",
"SYNOLOGY_CHAT_PASS",
"ghcr.io/louis-lastella/synology-chat-mcp:0.2.0"
],
"env": {
"SYNOLOGY_CHAT_URL": "<SYNOLOGY_CHAT_URL>",
"SYNOLOGY_CHAT_USER": "<SYNOLOGY_CHAT_USER>",
"SYNOLOGY_CHAT_PASS": "<SYNOLOGY_CHAT_PASS>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"synology-chat-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SYNOLOGY_CHAT_URL",
"-e",
"SYNOLOGY_CHAT_USER",
"-e",
"SYNOLOGY_CHAT_PASS",
"ghcr.io/louis-lastella/synology-chat-mcp:0.2.0"
],
"env": {
"SYNOLOGY_CHAT_URL": "<SYNOLOGY_CHAT_URL>",
"SYNOLOGY_CHAT_USER": "<SYNOLOGY_CHAT_USER>",
"SYNOLOGY_CHAT_PASS": "<SYNOLOGY_CHAT_PASS>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
SYNOLOGY_CHAT_URLBase URL of your Synology Chat server, e.g. https://nas.example.com:5001RequiredSYNOLOGY_CHAT_USERUsername of the Synology account (no 2FA)RequiredSYNOLOGY_CHAT_PASSPassword of the Synology accountRequiredSYNOLOGY_CHAT_VERIFY_SSLSet to false for self-signed certificates
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- list_channels
- List joined channels and DMs.
- find_user
- Find users by partial username.
- get_recent_posts
- Get recent messages in a channel or DM.
- dm_channel_for_user
- Get the 1:1 DM channel for a user.
- send_message
- Post a text message.
- send_file
- Upload a local file with an optional message.
What it does
- Channel listing
- Lists joined channels and DMs with members and unread counts.
- User search
- Finds users by partial username.
- Recent posts
- Reads the latest messages and files in a channel.
- Direct message lookup
- Finds the 1:1 channel for a user.
- Send messages
- Posts text to a channel or DM.
- File upload
- Uploads a local file with an optional message.
Good for
- Summarise unread messages in a team channel
- Post a status update to a channel from an assistant
- Send a generated report file to a colleague
- Find the DM channel for a user
Pricing
Open source
MIT licence
Synology Chat FAQ
Does it need a bot or webhook?
No. It logs in as a normal DSM user through the Web API.
Does it support two-factor accounts?
No. The README says to use an account without 2FA.
Can it download attachments?
Not yet; downloading attachments is not a tool.
How do I run it?
With uvx from GitHub, from a local clone, or from the ghcr.io Docker image.
Is Synology Chat free?
Yes. Synology Chat is open source, so you can use and self-host it for free.
How do I add Synology Chat to Claude Code?
Run this command in your terminal: claude mcp add synology-chat-mcp --env SYNOLOGY_CHAT_URL='<SYNOLOGY_CHAT_URL>' --env SYNOLOGY_CHAT_USER='<SYNOLOGY_CHAT_USER>' --env SYNOLOGY_CHAT_PASS='<SYNOLOGY_CHAT_PASS>' -- docker run -i --rm -e SYNOLOGY_CHAT_URL -e SYNOLOGY_CHAT_USER -e SYNOLOGY_CHAT_PASS ghcr.io/louis-lastella/synology-chat-mcp:0.2.0
What are the best alternatives to Synology Chat?
The closest alternatives to Synology Chat are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

