Skip to main content
Glama

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

Related 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_channels()

List joined channels/DMs (id, name, type, unread)

find_user(name_query)

Find users by partial username

get_recent_posts(channel_id, limit=20)

Read recent messages in a channel

dm_channel_for_user(user_id)

Get the 1:1 DM channel id for a user

send_message(channel_id, message)

Post a text message

send_file(channel_id, file_path, message="")

Upload a file, optionally with a caption message

Available Tools

6 tools
dm_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

    A3.7/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      33
      2
      MIT