# `liveblocks-mcp-server`
This MCP server allows AI to use a number of functions from our [REST API](https://liveblocks.io/docs/api-reference/rest-api-endpoints). 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](https://liveblocks.io/docs/tools/mcp-server).
## Setup
To install, copy your Liveblocks secret key from a project in [your dashboard](https://liveblocks.io/dashboard) and run one of the following commands, replacing `sk_xxxxxxxxxxxx` with your secret key.
### Cursor
Read more
1. Go to File → Cursor Settings → MCP → Add new server.
2. Add the following, inserting your secret key:
```json
{
"mcpServers": {
"liveblocks": {
"command": "npx",
"args": ["-y", "github:liveblocks/liveblocks-mcp-server"],
"env": {
"LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
}
}
}
}
```
Read more
Run the following command in the terminal, inserting your secret key:
```bash
claude mcp add liveblocks -e LIVEBLOCKS_SECRET_KEY=sk_xxxxxxxxxxxx -- npx -y github:liveblocks/liveblocks-mcp-server
```
Read more
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:
```json
{
"mcpServers": {
"liveblocks": {
"command": "npx",
"args": ["-y", "github:liveblocks/liveblocks-mcp-server"],
"env": {
"LIVEBLOCKS_SECRET_KEY": "sk_xxxxxxxxxxxx"
}
}
}
}
```
4. Restart Claude Desktop to apply the changes.
Read more
1. Ensure the Codex CLI is installed:
```bash
npm i -g @openai/codex
```
2. 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
```