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

  1. Go to File → Cursor Settings → MCP → Add new server.
  2. Add the following, inserting your secret key:
{
  "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:

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

Claude Desktop

  1. Go to Settings → Developer → Edit Config.

  2. Open the JSON file, claude_desktop_config.json.

  3. Add the following to the JSON, inserting your secret key:

{
  "mcpServers": {
    "liveblocks": {
      "command": "npx",
      "args": ["-y", "github:liveblocks/liveblocks-mcp-server"],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
      }
    }
  }
}
  1. Restart Claude Desktop to apply the changes.

Codex

  1. Ensure the Codex CLI is installed:
npm i -g @openai/codex
  1. Run the following command in the terminal, inserting your secret key:
codex mcp add liveblocks \
  --env LIVEBLOCKS_SECRET_KEY=sk_xxxxxxxxxxxx \
  -- npx -y github:liveblocks/liveblocks-mcp-server