RocketChat

Provides an MCP server that connects Rocket.Chat with an MCP client for local testing and automation.

python

3

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "elieworkspace-rocketchat-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/Users/-username-/Desktop/mcp-rocketchat",
        "run",
        "rocketchat.py",
        "--server-url",
        "http://localhost:3000",
        "--username",
        "-username-",
        "--password",
        "-password-"
      ]
    }
  }
}

RocketChat MCP Server lets you bridge Rocket.Chat with an MCP client for local testing and automation. It provides a repeatable runtime to run a Rocket.Chat-based MCP workflow from your machine, enabling quick iteration and integration with your existing MCP clients.

How to use

You run the MCP server locally and connect a client to it to perform tasks with Rocket.Chat. Start the Rocket.Chat instance using Docker, then run the MCP client configuration to point to your local server. Use the client to send commands, automate conversations, and test integrations in a safe, local environment.

How to install

Prerequisites you need before you begin are Docker and Python installed on your system. You will also rely on the MCP tooling used to run the Python client and manage virtual environments.

{
  "type": "http",
  "name": "rocketchat",
  "url": null
}

Additional content

Note the following setup steps to get Rocket.Chat MCP running locally. Start the Rocket.Chat server with Docker, configure a Python environment, install the MCP CLI, and provide the client with a configuration that points to your local Rocket.Chat instance.

# Start Rocket.Chat with Docker
docker compose up -d

# Access Rocket.Chat at the default port
# http://localhost:3000

# Initial configuration inside the browser after first login
# Disable 2FA and Save

Configuration details

The MCP client configuration for running Rocket.Chat locally uses the Python-based runtime to start rocketchat.py and connect to your local Rocket.Chat server. Provide your local server URL and credentials when you run the client.

{
  "type": "stdio",
  "name": "rocketchat",
  "command": "uv",
  "args": [
    "--directory",
    "C:/Users/-username-/Desktop/mcp-rocketchat",
    "run",
    "rocketchat.py",
    "--server-url", "http://localhost:3000",
    "--username", "-username-",
    "--password", "-password-"
  ]
}

Security and maintenance

Ensure Docker is running securely and keep your Rocket.Chat instance updated. Treat the local MCP server like any development service: use strong credentials, restrict access to your machine, and back up important data regularly.

Available tools

docker_compose_up

Starts services defined in a Docker Compose file to bring Rocket.Chat online for local MCP testing.

python_venv_setup

Creates and activates a Python virtual environment for running MCP-related Python tooling.

uvx_install_mcp_cli_httpx

Installs the MCP CLI and the HTTPX extension for making MCP requests in Python.

rocketchat_client_config

Configures a local MCP client to connect to the Rocket.Chat MCP server with server URL and credentials.