Guides
Can I connect Claude Code to Roblox Studio?
Yes, Claude Code connects to Roblox Studio's built-in MCP server. The claude mcp add command, the StudioMCP JSON config explained, and fixes.
7 min read

Quick answer
Can I connect Claude Code to Roblox Studio?
Yes. Roblox Studio has a built-in MCP server that Claude Code can use. Turn it on in Assistant under Manage MCP Servers, then connect with Quick connect, Roblox's official Claude Code plugin, or one command on macOS: claude mcp add Roblox_Studio -- followed by the StudioMCP path inside RobloxStudio.app. Studio must be running on the same computer.
Can you connect Claude Code to Roblox Studio?
Yes, you can connect Claude Code to Roblox Studio. Studio has a built-in MCP server that speaks the Model Context Protocol, and Claude Code is an MCP client. Once they're connected, Claude Code can explore your place's data model, read and edit scripts, run Luau, insert assets, generate meshes and run playtests in your open Studio session.
There are four ways to connect. Use the first one that works for you:
- Quick connect inside Studio.
- Roblox's official plugin for Claude Code.
- One
claude mcp addcommand. - A JSON entry in
.mcp.json.
All four need the same first step, and all four need Studio running on the same computer as Claude Code. The server runs as a local process and talks to Claude Code over stdio, so claude.ai in a browser can help you write Luau but can't reach Studio.
For the general setup across Cursor, Codex and other clients, see the Roblox Studio MCP server guide. This page sticks to Claude Code.
Step 1: turn on Studio's MCP server
- Update Roblox Studio to the latest version.
- Open Assistant.
- Click … ⟩ Manage MCP Servers. Newer builds label it … ⟩ Settings ⟩ MCP Servers.
- Turn on Enable Studio as MCP server.
When a client connects, a green indicator in this panel shows how many are connected.
Option 1: Quick connect
In the same panel, expand Quick connect. It lists supported clients installed on your computer: Antigravity, Codex CLI, Claude Code, Claude Desktop, Cursor, Gemini CLI and Visual Studio Code. Turn on Claude Code. If it isn't listed, install Claude Code and restart Studio. This is the least typing, so try it first.
Option 2: Roblox's official plugin
Roblox publishes a Roblox Studio plugin for Claude Code. In a Claude Code session, run /plugin, search for Roblox Studio and install it. Then ask "Get me set up with Roblox Studio." It checks what's missing, can install and open Studio after one approval, and tells you where to flip the MCP switch. You still turn the switch on yourself.
To verify, run /mcp. The plugin registers two servers, plugin:roblox-studio:macos and plugin:roblox-studio:windows. Only the one for your operating system connects, so the other showing as failed is expected.
Option 3: the claude mcp add command
Claude Code adds local servers with claude mcp add <name> -- <command>, where everything after the -- is the command that starts the server (Claude Code MCP docs).
- macOS:
claude mcp add Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP - Windows:
claude mcp add Roblox_Studio -- cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
Both paths come from Roblox's docs. If you installed Studio in ~/Applications on a Mac, Roblox's plugin notes say StudioMCP can live there instead, so adjust the path.
By default this writes to local scope: it loads only in the project folder where you ran it and is stored in ~/.claude.json. Add a scope flag to change that:
--scope usermakes Roblox Studio available in all your projects.--scope projectwrites it to.mcp.jsonin the project root, so teammates who clone the repo get it too. Claude Code asks each person to approve project servers before they load.
A successful add prints an Added ... line. Then run claude mcp list and look for ✔ Connected next to Roblox_Studio, or claude mcp get Roblox_Studio for details.

The JSON config, line by line
Many people search for this exact string:
{ "mcpServers": { "Roblox_Studio": { "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP" } } }
It's Roblox's macOS configuration, and each part has a job:
mcpServersis the wrapper key that Claude Code, Claude Desktop, Cursor and most other clients read. Everything inside it is one server per key.Roblox_Studiois the server's name. You can call it anything that uses letters, numbers, hyphens and underscores, but this is the name Roblox uses, and it's what you'll see in/mcp.commandis the program the client launches. Here it'sStudioMCP, a small binary inside the Roblox Studio app bundle. Right-clicking RobloxStudio.app and choosing Show Package Contents shows it underContents/MacOS.- No
argsand notype. Claude Code reads an entry without atypeas a stdio server, which is exactly what Studio's server is.
On Windows the same entry uses "command": "cmd.exe" with "args": ["/c", "%LOCALAPPDATA%\\Roblox\\mcp.bat"]. The doubled backslashes are JSON escaping.
Copy the casing exactly. Search engines show the string in lowercase. JSON keys are case-sensitive, so mcpservers is not mcpServers, and a lowercase key won't be read.
To use the JSON with Claude Code, you have two choices:
- Put the whole block in
.mcp.jsonat your project root. If the file already has servers, addRoblox_Studioas one more key insidemcpServers, with a comma between entries. Roblox notes a missing comma is enough to stop the whole file loading. - Or pass just the inner object to
claude mcp add-json:claude mcp add-json Roblox_Studio '{"command":"/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"}'. Claude Code's docs say to pass the object insidemcpServers, not the wrapper.
Check that it works
- In Studio, the MCP panel shows the green connected indicator.
- In Claude Code, run
/mcpand confirmRoblox_Studio(or the plugin's server) is connected. - Ask something read-only, such as "List what's in Workspace" or "list my open Roblox Studio windows".
If you have several Studio windows open, every tool call carries a studio_id, and the list_roblox_studios tool tells Claude which is which.
If it doesn't connect, restart both Studio and Claude Code, check the binary path exists, and validate your JSON. Those are Roblox's own first three fixes. The rest are in Roblox Studio MCP not connecting.
Which option should you use?
- Quick connect: fewest steps, managed by Studio. Best if you just want it working.
- Official plugin: adds Roblox's setup and skill instructions, and can install Studio for you. Best for newcomers. More on skills in Roblox Claude skills.
claude mcp add: explicit, scriptable, easy to scope to one project or all of them. Best if you manage several MCP servers..mcp.jsonin the repo: shared with your team through Git. Best for studios.
Before you let Claude loose
Roblox warns that MCP clients can read and modify your open places. Only connect clients you trust, review what Claude proposes, and save or commit before larger changes. Roblox's plugin notes add that not every change can be undone from Studio. Roblox's coding harness guide sets up Script Sync and Git from the start, and build Roblox games with Claude walks through that workflow.
Using Codex instead? See Codex and Roblox Studio MCP.
What Claude Code doesn't do here
Claude Code is very good at Luau, systems and test-fix loops. Over MCP it can also call Studio's own mesh generator and insert Creator Store assets, which is fine for placeholders. For custom props that match your game, you'll want models made from your own input. Vi3W turns a prompt, photo or sketch into a retopologised, textured mesh you export as GLB, FBX or OBJ and import with Studio's Importer. It has no MCP server or Claude integration, so you import the file yourself, then ask Claude to wire it up. Make a prop in Vi3W.
Frequently asked questions
can i connect claude code to roblox studio
Yes. Studio ships its own MCP server, and Claude Code is one of the clients in Studio's Quick connect list. Open Assistant ⟩ … ⟩ Manage MCP Servers, turn on Enable Studio as MCP server, and enable Claude Code. Or install Roblox's official Roblox Studio plugin with /plugin in Claude Code. Both need Studio running on your own Mac or Windows PC.
{ "mcpservers": { "roblox_studio": { "command": "/applications/robloxstudio.app/contents/macos/studiomcp" } } }
That's Roblox's macOS MCP configuration, lowercased by search. The real version is {"mcpServers": {"Roblox_Studio": {"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"}}}. It registers a server named Roblox_Studio that runs Studio's bundled StudioMCP program over stdio. Copy the casing exactly. In Claude Code, the one-line equivalent is claude mcp add Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP.
Last reviewed

