{
  "markdown": "<!-- mcp-name: io.github.millerchou/rocketchat-mcp -->\n\n# rocketchat-mcp\n\nAn [MCP](https://modelcontextprotocol.io) server for [Rocket.Chat](https://rocket.chat).\nIt lets MCP clients (Claude Desktop, Cursor, Claude Code, etc.) send and read\nmessages, send DMs, search history, upload/download files, and manage channels\non a Rocket.Chat workspace over stdio.\n\n> Actively maintained fork of\n> [elieworkspace/rocketchat-mcp](https://github.com/elieworkspace/rocketchat-mcp),\n> adding Personal Access Token auth, more tools, and reliability/security\n> improvements. See [NOTICE](NOTICE) for attribution.\n\n## Tools\n\n| Tool | Description |\n| --- | --- |\n| `send_message_in_channel` | Send a message to a channel |\n| `send_direct_message` | Send a direct message to a user |\n| `delete_message` | Delete a message (your own, unless the role has force-delete) |\n| `get_channel_messages` | Read history of a channel/group/DM; supports `offset` paging and accepts a room ID or name |\n| `search_messages` | Keyword search within a room (`chat.search`) |\n| `get_unread` | List rooms with unread messages and their latest content |\n| `send_file` | Upload a file to a channel or `@user` |\n| `download_attachment` | Download a message's attachments to local files |\n| `list_all_rooms` | List channels, groups and DMs &lowast; |\n| `list_users` | List users &lowast; |\n| `get_user_info` | Get a user's profile |\n| `create_channel` | Create a channel |\n\n&lowast; `list_all_rooms` and `list_users` call workspace-wide endpoints\n(`channels.list` / `users.list`) that require admin or the corresponding\n`view-*` permission. Every other tool works for a normal chat user.\n\n## Authentication\n\nA normal chat user is enough for the core tools. A **Personal Access Token** is\nrecommended — it keeps the token out of process arguments:\n\n| Variable | Description |\n| --- | --- |\n| `ROCKETCHAT_SERVER_URL` | Workspace URL, e.g. `https://chat.example.com` |\n| `ROCKETCHAT_USER_ID` | Your Rocket.Chat user ID |\n| `ROCKETCHAT_AUTH_TOKEN` | Personal Access Token |\n| `ROCKETCHAT_WATCHDOG_INTERVAL` | (optional) orphan-watchdog interval in seconds, default `60` |\n\nUsername/password is also supported via `--username` / `--password`.\nUse `--no-verify-ssl` for self-signed certificates.\n\n## Usage\n\n### Run with uvx\n\n```bash\nuvx rocketchat-mcp --server-url https://chat.example.com\n```\n\nTo run the latest unreleased code straight from GitHub instead:\n\n```bash\nuvx --from git+https://github.com/millerchou/rocketchat-mcp rocketchat-mcp --server-url https://chat.example.com\n```\n\n### Client configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"rocketchat\": {\n      \"command\": \"uvx\",\n      \"args\": [\"rocketchat-mcp\"],\n      \"env\": {\n        \"ROCKETCHAT_SERVER_URL\": \"https://chat.example.com\",\n        \"ROCKETCHAT_USER_ID\": \"your_user_id\",\n        \"ROCKETCHAT_AUTH_TOKEN\": \"your_personal_access_token\"\n      }\n    }\n  }\n}\n```\n\n### Local development\n\n```bash\ngit clone https://github.com/millerchou/rocketchat-mcp\ncd rocketchat-mcp\nuv run rocketchat.py --server-url https://chat.example.com \\\n  --auth-token \"$ROCKETCHAT_AUTH_TOKEN\" --user-id \"$ROCKETCHAT_USER_ID\"\n```\n\n## Reliability\n\nPersistent HTTP connection pool, room-endpoint caching, log rotation (1 MB),\nand an orphan watchdog that self-exits when the MCP client process dies.\n\n## License\n\nModifications in this fork are released under the [MIT License](LICENSE).\nThis is a fork of upstream code originally published without a license; see\n[NOTICE](NOTICE) for details.\n",
  "bytes": 3484,
  "sha": "7691f8084d2ab68c22e9737fa76fb8d27dc905c06dcf96a1dea1fda949a84c12",
  "repo_slug": "millerchou/rocketchat-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_millerchou_rocketchat_mcp_fb39988a/readme"
}