MCP 服务器

Liveblocks

Tools

get-rooms

Get recent Liveblocks rooms

create-room

Create a Liveblocks room

get-threads

Get recent Liveblocks threads

create-thread

Create a Liveblocks thread. Always ask for a userId.

add-comment-reaction

Add a reaction to a Liveblocks comment

remove-comment-reaction

Remove a reaction from a Liveblocks comment

get-room

Get a Liveblocks room

update-room

Update a Liveblocks room

delete-room

Delete a Liveblocks room

update-room-id

Update a Liveblocks room's ID

get-active-users

Get a Liveblocks room's active users

broadcast-event

Broadcast an event to a Liveblocks room

get-storage-document

Get a Liveblocks storage document

get-yjs-document

Get a Liveblocks Yjs text document

get-thread

Get a Liveblocks thread

get-thread-participants

Get a Liveblocks thread's participants

edit-thread-metadata

Edit a Liveblocks thread's metadata. `null` can be used to remove a key.

mark-thread-as-resolved

Mark a Liveblocks thread as resolved

mark-thread-as-unresolved

Mark a Liveblocks thread as unresolved

delete-thread

Delete a Liveblocks thread

subscribe-to-thread

Subscribe to a Liveblocks thread

unsubscribe-from-thread

Unsubscribe from a Liveblocks thread

get-thread-subscriptions

Get a Liveblocks thread's subscriptions

create-comment

Create a Liveblocks comment. Always ask for a userId.

get-comment

Get a Liveblocks comment

edit-comment

Edit a Liveblocks comment

delete-comment

Delete a Liveblocks comment

get-room-subscription-settings

Get a Liveblocks room's subscription settings

update-room-subscription-settings

Update a Liveblocks room's subscription settings

delete-room-subscription-settings

Delete a Liveblocks room's subscription settings

get-user-room-subscription-settings

Get a user's room subscription settings

get-inbox-notifications

Get recent Liveblocks inbox notifications

get-inbox-notification

Get a Liveblocks inbox notification

trigger-inbox-notification

Create a custom Liveblocks inbox notification

delete-inbox-notification

Delete a Liveblocks inbox notification

delete-all-inbox-notifications

Delete all Liveblocks inbox notifications

get-notification-settings

Get a Liveblocks notification settings

update-notification-settings

Update Liveblocks notification settings

delete-notification-settings

Delete Liveblocks notification settings

README

`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.

Automatic setup

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

Cursor

npx -y @smithery/cli install @liveblocks/liveblocks-mcp-server --client cursor --key [key]

Claude Desktop

npx -y @smithery/cli install @liveblocks/liveblocks-mcp-server --client claude --key [key]

VS Code

npx -y @smithery/cli install @liveblocks/liveblocks-mcp-server --client vscode --key [key]

Other clients

Find installation information for other clients on Smithery.

Manual setup

<p></p>

Clone this repo.

git clone https://github.com/liveblocks/liveblocks-mcp-server.git

Build the project.

npm install
npm run build

Get your Liveblocks secret key from the dashboard.

sk_dev_Ns35f5G...

Cursor

Go to File → Cursor Settings → MCP → Add new server.
Add the following, with the full path to the repo and your secret key:

{
  "mcpServers": {
    "liveblocks-mcp-server": {
      "command": "node",
      "args": ["/full/path/to/the/repo/liveblocks-mcp-server/build/index.js"],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_dev_Ns35f5G..."
      }
    }
  }
}

Check it's enabled in the MCP menu.

Claude Desktop

Go to File → Settings → Developer → Edit Config.
Open the JSON file, claude_desktop_config.json.
Add the following, with the full path to the repo and your secret key:

{
  "mcpServers": {
    "liveblocks-mcp-server": {
      "command": "node",
      "args": ["/full/path/to/the/repo/liveblocks-mcp-server/build/index.js"],
      "env": {
        "LIVEBLOCKS_SECRET_KEY": "sk_dev_Ns35f5G..."
      }
    }
  }
}