rocketchat-mcp

rocketchat-mcp

An MCP server for Rocket.Chat. It lets MCP clients (Claude Desktop, Cursor, Claude Code, etc.) send and read messages, send DMs, search history, upload/download files, and manage channels on a Rocket.Chat workspace over stdio.

Actively maintained fork of elieworkspace/rocketchat-mcp, adding Personal Access Token auth, more tools, and reliability/security improvements. See NOTICE for attribution.

Tools

Tool	Description
send_message_in_channel	Send a message to a channel
send_direct_message	Send a direct message to a user
delete_message	Delete a message (your own, unless the role has force-delete)
get_channel_messages	Read history of a channel/group/DM; supports offset paging and accepts a room ID or name
search_messages	Keyword search within a room (chat.search)
get_unread	List rooms with unread messages and their latest content
send_file	Upload a file to a channel or @user
download_attachment	Download a message's attachments to local files
list_all_rooms	List channels, groups and DMs ∗
list_users	List users ∗
get_user_info	Get a user's profile
create_channel	Create a channel

∗ list_all_rooms and list_users call workspace-wide endpoints (channels.list / users.list) that require admin or the corresponding view-* permission. Every other tool works for a normal chat user.

Authentication

A normal chat user is enough for the core tools. A Personal Access Token is recommended — it keeps the token out of process arguments:

Variable	Description
ROCKETCHAT_SERVER_URL	Workspace URL, e.g. https://chat.example.com
ROCKETCHAT_USER_ID	Your Rocket.Chat user ID
ROCKETCHAT_AUTH_TOKEN	Personal Access Token
ROCKETCHAT_WATCHDOG_INTERVAL	(optional) orphan-watchdog interval in seconds, default 60

Username/password is also supported via --username / --password. Use --no-verify-ssl for self-signed certificates.

Usage

Run with uvx (no clone)

uvx --from git+https://github.com/millerchou/rocketchat-mcp rocketchat-mcp \
  --server-url https://chat.example.com

Once published to PyPI this becomes simply uvx rocketchat-mcp.

Client configuration

{
  "mcpServers": {
    "rocketchat": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/millerchou/rocketchat-mcp", "rocketchat-mcp"],
      "env": {
        "ROCKETCHAT_SERVER_URL": "https://chat.example.com",
        "ROCKETCHAT_USER_ID": "your_user_id",
        "ROCKETCHAT_AUTH_TOKEN": "your_personal_access_token"
      }
    }
  }
}

Local development

git clone https://github.com/millerchou/rocketchat-mcp
cd rocketchat-mcp
uv run rocketchat.py --server-url https://chat.example.com \
  --auth-token "$ROCKETCHAT_AUTH_TOKEN" --user-id "$ROCKETCHAT_USER_ID"

Reliability

Persistent HTTP connection pool, room-endpoint caching, log rotation (1 MB), and an orphan watchdog that self-exits when the MCP client process dies.

License

Modifications in this fork are released under the MIT License. This is a fork of upstream code originally published without a license; see NOTICE for details.