bbw-chat
Provides tools to interact with Synology Chat (bbw-chat.de), including listing channels, reading recent messages, finding users, retrieving DM channel IDs, and sending messages and files.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bbw-chat show my unread messages from all channels"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bbw-chat-mcp
MCP server for bbw-chat.de (Synology Chat). Read channels/messages, find users, send messages and files — from any MCP client (Claude, Hermes, etc.).
Setup
git clone https://github.com/Louis-Lastella/bbw-chat-mcp.git
cd bbw-chat-mcp
cp .env.example .env # fill in your credentials
uv sync.env:
BBW_CHAT_HOST=bbw-chat.de
BBW_CHAT_USER=your-username
BBW_CHAT_PASS=your-passwordRelated MCP server: bluebubbles-mcp
Use with an MCP client
Add to your client's MCP config (e.g. Claude Desktop claude_desktop_config.json, or Hermes config.yaml):
{
"mcpServers": {
"bbw-chat": {
"command": "uv",
"args": ["run", "--directory", "/absolute/path/to/bbw-chat-mcp", "server.py"]
}
}
}Restart the client — 6 tools show up: list_channels, find_user, get_recent_posts, dm_channel_for_user, send_message, send_file.
Tools
Tool | What it does |
| List joined channels/DMs (id, name, type, unread) |
| Find users by partial username |
| Read recent messages in a channel |
| Get the 1:1 DM channel id for a user |
| Post a text message |
| Upload a file, optionally with a caption message |
Available Tools
6 toolsdm_channel_for_userDm Channel For UserA
Find (or None if none exists yet) the 1:1 DM channel_id for a given user_id.
Inputs: user_id (required). Returns: result
find_userFind UserA
Find users by (partial, case-insensitive) username, e.g. 'wilke'.
Inputs: name_query (required). Returns: result
get_recent_postsGet Recent PostsA
Read recent messages/tasks in a channel (use to check for new Ausbilder-Aufgaben).
Inputs: channel_id (required), limit. Returns: result
list_channelsList ChannelsA
List all joined chat channels/DMs with id, name, type, last_post_at.
Inputs: no named parameters. Returns: result
send_fileSend FileB
Upload a file to a channel/DM, optionally followed by a text message.
Inputs: file_path (required), channel_id (required), message. Returns: object
send_messageSend MessageC
Post a text message to a channel/DM.
Inputs: message (required), channel_id (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have clearly distinct roles: listing channels, finding users, reading posts, sending messages, and uploading files. There is minor overlap between list_channels and dm_channel_for_user for locating DM channels, and between send_message and send_file's optional text, but the descriptions resolve these well enough.
Tool names are lowercase snake_case and mostly follow a verb_noun pattern such as list_channels, find_user, and send_message. The main inconsistency is dm_channel_for_user, which lacks a leading verb and would be clearer as get_dm_channel_for_user, and get_recent_posts uses get instead of list.
Six tools form a compact, well-scoped toolkit for a chat server. Each tool covers a necessary part of the core workflow: discovering channels/users, reading messages, and sending text or files.
The set covers the essential chat lifecycle: list channels, find users, read recent posts, send messages, and send files. Minor gaps like creating/joining channels or editing/deleting messages are not critical to the apparent use case and can be worked around.
Related MCP Connectors
MCP server for Sendbird — chat users, channels, members, and messages from your AI client.
Chat with your Zihin.ai agents, list them and load platform skills from any MCP client.
Agent communication platform for agent to agent messaging via MCP. Messages, channels, skills.
Your own WhatsApp as an MCP server: read, search and send from any MCP client.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Rocket.Chat instances through MCP protocol. Allows users to manage chat operations and integrate with Rocket.Chat servers using natural language commands.6-
- AlicenseAqualityCmaintenanceEnables interaction with iMessage through a BlueBubbles server, allowing users to read, search, and send messages directly from MCP clients. It supports comprehensive chat management features including reactions, group chat moderation, message scheduling, and contact lookups.332MIT

@chatmaid/mcpofficial
AlicenseAqualityCmaintenanceEnables sending WhatsApp messages and managing Chatmaid account from any MCP-compatible AI client.88 npmMIT- FlicenseCqualityCmaintenanceMCP server for the Stashcat messenger API. Enables AI assistants to read and send messages, manage channels, conversations, files, polls, and more.100-