Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Chrrxs/robloxstudio-mcp/llms.txt

Use this file to discover all available pages before exploring further.

The Roblox Studio MCP plugin (MCPPlugin.rbxmx) is a Studio-side bridge that polls the MCP server every 500 ms for queued tool calls, executes them using Studio APIs, and returns the results. The plugin must be present in Studio’s Plugins folder and loaded before the agent can communicate with a live session. There are four ways to install it — pick the one that fits your workflow.
Only one plugin variant at a time. Do not leave both MCPPlugin.rbxmx (full edition) and MCPInspectorPlugin.rbxmx (Inspector Edition) in the Studio Plugins folder simultaneously. Studio loads every file in that folder on startup; having both causes duplicate runtime peers and unpredictable routing. The CLI installers remove the other variant automatically before copying the new one.
The simplest approach: pass --auto-install-plugin when wiring up the MCP server. Every time the server process starts, it copies the .rbxmx bundled with that npm release into Studio’s Plugins folder, keeping the plugin version in sync with the server automatically.
1
Add the server with the auto-install flag
2
Claude Code
claude mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin
Codex CLI
codex mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin
Gemini CLI
gemini mcp add robloxstudio npx --trust -- -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin
Claude Desktop / Cursor
{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "npx",
      "args": ["-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
    }
  }
}
3
Fully close and reopen Roblox Studio
4
Studio loads plugins only at startup. A full quit-and-reopen is required after the first install or after any plugin update.
5
Confirm the plugin loaded
6
Open the Plugins toolbar. You should see the MCP Server button. Click it to open the dock widget and check the connection status.

​
Method 2 — Manual CLI install

Run the install command once from any terminal to copy the plugin into the default Plugins folder without starting the MCP server:
1
Run the install command
2
npx -y @chrrxs/robloxstudio-mcp@latest --install-plugin
3
Fully close and reopen Roblox Studio
4
Confirm the plugin loaded

​
Method 3 — Roblox Creator Store

1
Visit the Creator Store listing
2
Open https://create.roblox.com/store/asset/132985143757536 in your browser while logged into your Roblox account.
3
Click Install
4
The plugin is added to your account. Studio will prompt you to load it the next time it starts.
5
Reopen Studio if it is already running
6
No further configuration is needed. The MCP Server button appears in the Plugins toolbar automatically.

​
Method 4 — Direct file download

1
Download MCPPlugin.rbxmx
2
Grab the latest release asset directly:
3
https://github.com/chrrxs/robloxstudio-mcp/releases/latest/download/MCPPlugin.rbxmx
4
Copy the file to the Studio Plugins folder
5
PlatformDefault pathWindows%LOCALAPPDATA%\Roblox\Plugins\macOS~/Documents/Roblox/Plugins/
6
Remove MCPInspectorPlugin.rbxmx from this folder if it is present before copying the new file.
7
Fully close and reopen Roblox Studio

​
Custom Plugins folder

If your Roblox Plugins folder is in a non-standard location, set the MCP_PLUGINS_DIR environment variable before running either --auto-install-plugin or --install-plugin. This works on Windows, macOS, and WSL. 
MCP_PLUGINS_DIR="/path/to/custom/Plugins" npx -y @chrrxs/robloxstudio-mcp@latest --install-plugin
On Windows (PowerShell): 
$env:MCP_PLUGINS_DIR = "C:\custom\Roblox\Plugins"
npx -y @chrrxs/robloxstudio-mcp@latest --install-plugin

​
Version mismatch

If the Studio plugin and the running MCP server were installed from different releases, the plugin stays connected but displays a yellow warning banner. The get_connected_instances response, /health, and /status endpoints also report pluginVersion, serverVersion, and versionMismatch: true. The connection remains usable, but some newer tool parameters may not be understood by the older plugin. To resolve:
1
Restart the MCP server with —auto-install-plugin
2
This overwrites the plugin file in the Plugins folder with the version that matches the running server package.
3
Fully close and reopen Roblox Studio
4
Studio must reload the updated .rbxmx from disk. The yellow banner disappears once the versions match.

​
Connecting multiple Studio places

You can open several Studio place files and connect all of them to the same MCP server — there is no need to run separate server instances. Call get_connected_instances to list every connected place and obtain each one’s instance_id, then pass that ID to any tool call to route it to the correct game window.

Build docs developers (and LLMs) love

Get started for freeTalk to us