# Synology Chat

> Synology Chat is an open-source MCP server for communication. Read Synology Chat channels, find users and send messages or files through your own NAS. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/louis-lastella/synology-chat-mcp
- **MCP Registry name:** io.github.Louis-Lastella/synology-chat-mcp
- **Categories:** [communication](https://ai-powered.com/categories/communication), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.

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