Skip to main content
Glama
evlon

codebuddy-matrix-channel

by evlon

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MATRIX_E2EENoWhether to enable end-to-end encryption for Matrix rooms.false
MATRIX_USERNoMatrix username for password login. Alternative to MATRIX_ACCESS_TOKEN.
MATRIX_USER_IDNoOptional Matrix user ID used to identify the bot's own messages, e.g. @alice:matrix.org.
MATRIX_OWNER_IDYesMatrix user ID of the owner/manager. Only this identity can grant approvals. Required.
MATRIX_PASSWORDNoMatrix password for password login. Alternative to MATRIX_ACCESS_TOKEN.
MATRIX_ALLOWLISTYesComma-separated sender user IDs allowed to send messages. Must be configured.
MATRIX_CRYPTO_DBNoNot effective in matrix-js-sdk 42.x; kept for compatibility.
MATRIX_MEDIA_DIRNoDirectory for downloaded media..matrix-media
MATRIX_HOMESERVERYesThe Matrix homeserver URL, e.g. https://matrix.org (required).
MATRIX_GATEWAY_URLNoFull URL of the local CodeBuddy service, e.g. http://127.0.0.1:9099. Lower priority than MATRIX_GATEWAY_PORT.
MATRIX_ACCESS_TOKENNoAccount access token. Alternative to MATRIX_USER / MATRIX_PASSWORD.
MATRIX_GATEWAY_PORTNoLocal CodeBuddy service port. Alternative to MATRIX_GATEWAY_URL.9099
MATRIX_GATEWAY_DEBUGNoSet to 1 to write raw Gateway SSE events to matrix-gateway-debug.log.0
MATRIX_TRUSTED_ROOMSNoComma-separated trusted room IDs where all work is automatically executed.
MATRIX_DOWNLOAD_MEDIANoWhether to download images/files and inject them as [file: path].false
MATRIX_ROOM_ALLOWLISTNoComma-separated room IDs allowed to be listened to. Leave empty to allow all.
MATRIX_AUTHORIZED_WORKNoFree text describing routinely authorized work, used to distinguish common vs unfamiliar requests.
MATRIX_CONTROL_ROOM_IDNoMatrix room ID for permission approval. Optional but required for the digital avatar mode.
MATRIX_HIGH_RISK_TOOLSNoComma-separated high-risk tools that always require approval.Bash,Write,Edit,MultiEdit,NotebookEdit
MATRIX_TRUSTED_SENDERSNoComma-separated trusted colleague user IDs whose work is automatically executed.
MATRIX_GATEWAY_PASSWORDNoGateway password. Defaults to reading ~/.codebuddy/settings.json gateway.password.
MATRIX_MENTION_REQUIREDNoWhether to only respond to @mentions in group rooms.true
MATRIX_STREAM_TIMEOUT_MSNoTimeout in milliseconds for fetching Gateway run SSE replies.300000
MATRIX_ROOM_CONTEXT_TURNSNoNumber of per-room context turns injected into the model context. 0 disables.6

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}
experimental
{
  "claude/channel": {},
  "claude/channel/permission": {}
}

Tools

Functions exposed to the LLM to take actions

NameDescription
replyA

通过 Matrix 把回复发送到指定房间(chat_id)。省略 chat_id 时回复发往最近一次转发进来的房间(原路返回)。发送会按配置自动重试;若多次仍发不回来源房间,则改用默认回复(MATRIX_DEFAULT_REPLY)发往控制室/owner 私聊兜底。

health_checkA

运行连接/E2EE 自检(等价于 npm run doctor),返回 Matrix 连接与加密状态。可在 /mcp 健康检查中调用。

request_approvalA

当判断当前任务来自陌生来源或含高风险时调用,把任务升级到管理者控制室等待审批。管理者回复 approve 后任务会被重放并执行。

room_membersA

获取指定 Matrix 房间(群聊)的在场成员列表,返回每个成员的 user_id 与 display_name,用于了解「谁在场」。chat_id 省略时取最近一次转发进来的房间。

list_roomsA

列出本分身已加入的所有 Matrix 房间(room_id + 标题),用于了解「我在哪些房间 / 群」。当不知道该回哪个房间时,可据此找到与管理者(owner)的私聊房间。

room_infoA

获取指定 Matrix 房间(群/私聊)的可读信息:名称、主题、成员昵称与 ID。用于配置与检查「房间 ID ↔ 名称」映射。chat_id 省略时取最近一次转发进来的房间。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/evlon/matrix-channel'

If you have feedback or need assistance with the MCP directory API, please join our Discord server