Skip to main content
Glama
GavinTomlins

rocketchat-mcp-server

by GavinTomlins

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_PORTNoPort for HTTP transport (default: 8000)
READ_ONLYNoSet to 'true' to enable read-only mode (write tools hidden)
RCMCP_LOG_JSONNoSet to 'true' to enable JSON logging
ROCKETCHAT_URLYesURL of the Rocket.Chat server (e.g., https://chat.example.com)
RCMCP_READ_ONLYNoAlternative to READ_ONLY using RCMCP_ prefix
ROCKETCHAT_USER_IDYesUser ID corresponding to the auth token
RCMCP_APPROVE_WRITESNoSet to 'true' to require human approval for consequential writes
RCMCP_ENABLE_METRICSNoSet to 'true' to expose /metrics endpoint
RCMCP_GATEWAY_TOKENSNoComma-separated token:principal pairs for HTTP transport gateway
ROCKETCHAT_AUTH_TOKENYesPersonal access token for authentication

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_channelsA

List public channels. Optional query filters by name substring.

list_joined_channelsB

List channels the authenticated user has joined.

get_channel_infoA

Get details for a channel or private group by name or ID.

list_groupsA

List private groups the authenticated user belongs to.

get_channel_membersC

List members of a channel or private group.

get_channel_messagesB

Get channel history, newest first.

group merges consecutive same-user messages within 60s (token saver). expand_threads fetches thread replies. compact truncates to id/user/text/ts.

search_messagesC

Search for text within a channel.

get_message_contextC

Get N messages before and after a target message (target flagged is_target).

send_messageC

Post a message to a channel or group.

edit_messageC

Edit an existing message (needs room_id and message_id).

delete_messageC

Delete a message (needs room_id and message_id). Destructive.

get_thread_messagesC

Get the replies in a thread.

get_pinned_messagesB

Get pinned messages in a channel.

reply_to_threadA

Reply into a thread. channel is auto-resolved from the parent if omitted.

add_reactionB

Add an emoji reaction to a message (e.g. :thumbsup:).

pin_messageC

Pin a message.

unpin_messageC

Unpin a message.

list_usersB

List users. Optional query filters by name substring.

get_user_infoA

Get details for a user by username.

list_dmsB

List direct-message conversations.

send_dmA

Send a direct message to a user (creates the DM room if needed).

list_room_filesC

List files shared in a room.

download_fileA

Download a file from the configured Rocket.Chat server.

Returns an image, plain text, or a base64 blob depending on content type. Only fetches from the configured server host (SSRF-guarded, 25 MB cap).

send_fileB

Upload a base64-encoded file to a room.

get_channel_digestA

Summarise channel activity over the last N hours (active users, threads, files).

get_mentionsB

Get messages that mention the authenticated user in a channel.

get_unread_channelsA

List channels with unread messages, sorted by unread count descending.

mark_as_readB

Mark all messages in a channel as read (clears the unread counter).

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/GavinTomlins/rocketchat-mcp-server'

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