Set Up Roblox Studio MCP with Claude, Codex, or Gemini

Roblox Studio MCP is distributed as an npm package and launched on-demand by your AI tool via npx. No global install is required — @latest always fetches the newest release when the server process starts. Below are the exact commands and configuration blocks for every supported client.

All commands include --auto-install-plugin, which copies the matching MCPPlugin.rbxmx into Studio’s Plugins folder each time the server starts. This keeps the plugin version in sync with the server automatically. After the first install you must fully close and reopen Roblox Studio to load the new plugin file.

Client configuration

Claude Code
Codex CLI
Gemini CLI
Claude Desktop
Cursor / Other JSON clients

Run this command once in your terminal. Claude Code stores it in its MCP configuration and launches the server automatically when you start a session.

claude mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin

To verify the server is registered:

claude mcp list

codex mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin

The server is launched automatically whenever Codex starts a task that discovers MCP tools.

gemini mcp add robloxstudio npx --trust -- -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin

The --trust flag tells Gemini CLI to allow the server process to run without a confirmation prompt each time.

Open your Claude Desktop configuration file and add the server entry under mcpServers:macOS / Linux — ~/Library/Application Support/Claude/claude_desktop_config.json
Windows — %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "npx",
      "args": ["-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
    }
  }
}

Restart Claude Desktop after saving the file.

Windows users: If npx does not resolve when Claude Desktop launches the server, use the cmd /c wrapper below instead.

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
    }
  }
}

Cursor and any other MCP-compatible client that reads a JSON config file use the same format as Claude Desktop. Add the entry to your client’s MCP configuration:

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "npx",
      "args": ["-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
    }
  }
}

Windows — cmd wrapper variant:

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
    }
  }
}

Open Cloud flags

Some tools in the full edition use the Roblox Open Cloud API to perform cloud-side operations (asset management, DataStore access, etc.). These tools are disabled unless you supply your credentials via flags or environment variables.

Passing credentials as flags

Append the flags to the args array (or inline command) of whichever client config you are using:

claude mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin \
  --open-cloud-key YOUR_API_KEY \
  --creator-id YOUR_USER_ID

Passing credentials as environment variables

Alternatively, set these variables in the process environment before the server starts:

Flag	Environment variable	Description
`--open-cloud-key`	`ROBLOX_OPEN_CLOUD_API_KEY`	Your Roblox Open Cloud API key
`--creator-id`	`ROBLOX_CREATOR_USER_ID`	Your Roblox user ID (personal account)
`--creator-group-id`	`ROBLOX_CREATOR_GROUP_ID`	Your Roblox group ID (team account)

When both a flag and an environment variable are present, the flag takes precedence.

Routing tool calls to a specific Studio instance

If you have more than one Roblox Studio window open and both are connected to the same MCP server, the agent uses get_connected_instances to retrieve a list of connected places along with their instance_id values, then passes the relevant ID to subsequent tool calls to target the correct game. Per-place port numbers (e.g. 58742) are not the supported routing model — always use instance_id.

Overview

Installation

Core Concepts

Set Up Roblox Studio MCP with Claude, Codex, or Gemini

Client configuration

Open Cloud flags

Passing credentials as flags

Passing credentials as environment variables

Routing tool calls to a specific Studio instance

Build docs developers (and LLMs) love

Overview

Installation

Core Concepts

Documentation Index

​Client configuration

​Open Cloud flags

​Passing credentials as flags

​Passing credentials as environment variables

​Routing tool calls to a specific Studio instance

Build docs developers (and LLMs) love

Client configuration

Open Cloud flags

Passing credentials as flags

Passing credentials as environment variables

Routing tool calls to a specific Studio instance