`liveblocks-mcp-server`

This MCP server allows AI to use a number of functions from our REST API. For example, it can create, modify, and delete different aspects of Liveblocks such as rooms, threads, comments, notifications, and more. It also has read access to Storage and Yjs. Learn more in our docs.

Setup

To install, copy your Liveblocks secret key from a project in your dashboard and run one of the following commands, replacing sk_xxxxxxxxxxxx with your secret key.

Cursor

Go to File → Cursor Settings → MCP → Add new server.
Add the following, inserting your secret key:

config.json

{
  "mcpServers": {
    "liveblocks": {
      "command": "npx",
      "args": ["-y", "github:liveblocks/liveblocks-mcp-server"],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      }
    }
  }
}

Claude Code

Run the following command in the terminal, inserting your secret key:

Terminal

claude mcp add liveblocks -e LIVEBLOCKS_SECRET_KEY=sk_xxxxxxxxxxxx -- npx -y github:liveblocks/liveblocks-mcp-server

Claude Desktop

Go to Settings → Developer → Edit Config.
Open the JSON file, claude_desktop_config.json.
Add the following to the JSON, inserting your secret key:

config.json

{
  "mcpServers": {
    "liveblocks": {
      "command": "npx",
      "args": ["-y", "github:liveblocks/liveblocks-mcp-server"],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop to apply the changes.

Codex

Ensure the Codex CLI is installed:

Terminal

npm i -g @openai/codex

Run the following command in the terminal, inserting your secret key:

bash

codex mcp add liveblocks \
  --env LIVEBLOCKS_SECRET_KEY=sk_xxxxxxxxxxxx \
  -- npx -y github:liveblocks/liveblocks-mcp-server