Matrix MCP Server

What it does

Connects an AI assistant to a Matrix home server, allowing it to interact with decentralized messaging rooms, retrieve chat history, and manage communications in real-time.

Tools

• list-joined-rooms: Get all rooms the user has joined.
• get-room-info: Retrieve detailed room information.
• get-room-messages: Retrieve recent messages from a specific room.
• send-message: Send messages to rooms with text, HTML, or emote formatting.
• send-direct-message: Send private messages to specific users.
• create-room: Create new Matrix rooms with custom privacy settings.
• join-room: Join rooms via ID or alias.
• search-public-rooms: Discover public rooms to join.
• get-user-profile: Retrieve profile information for any user.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "matrix-server": {
      "command": "node",
      "args": ["/path/to/matrix-mcp-server/dist/http-server.js"],
      "env": {
        "MATRIX_HOMESERVER_URL": "https://matrix.example.com",
        "MATRIX_DOMAIN": "matrix.example.com"
      }
    }
  }
}

Supported hosts

• Claude Desktop
• VS Code