[v2.5.0] Roblox Studio MCP - Speed up your workflow by letting AI read paths and properties

:star: Star on GitHub for updates

Connect AI assistants like Claude, ChatGPT, Gemini, and Codex to Roblox Studio

GitHub | NPM | Download Plugin


What is This?

An MCP server that gives AI direct access to your Roblox Studio project. It can explore your game structure, read and edit scripts, create and modify instances, capture screenshots of your viewport, run playtests, and perform bulk operations, all locally and safely.

Setup

  1. Install the npm package and plugin in one go:
npx robloxstudio-mcp@latest
npx robloxstudio-mcp-install-plugin

Or install the Studio plugin manually to your Plugins folder.

  1. Enable Allow HTTP Requests in Game Settings > Security

  2. Connect your AI:

Claude Code:

claude mcp add robloxstudio -- npx -y robloxstudio-mcp@latest

Codex CLI:

codex mcp add robloxstudio -- npx -y robloxstudio-mcp@latest

Gemini CLI:

gemini mcp add robloxstudio npx --trust -- -y robloxstudio-mcp@latest

or in MCP config (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "npx",
      "args": ["-y", "robloxstudio-mcp@latest"]
    }
  }
}

Plugin shows “Connected” when ready.

What Can You Do?

Ask things like: “What’s the structure of this game?”, “Find scripts with deprecated APIs”, “Create 50 test NPCs in a grid”, “Take a screenshot and tell me what looks off”, “Run a playtest and fix any errors”

65+ tools including script editing, instance creation, property manipulation, scene building, screenshot capture, playtest automation, Luau execution, asset search, and more.


v2.5.0 – Screenshot capture, one-command plugin install, scene import improvements, 65+ tools

Report Issues | MIT Licensed

102 Likes

That is AWESOME. Thank you for making this. Can’t wait for script modification to come out!
One thing I noticed: Claude often tries to get all scripts in the game, and the plugin returns all scripts including core roblox scripts. That instantly kills the chat due to Claude hitting the maximum conversation limit, which is really annoying.

7 Likes

Hey looking into fixing this, this MCP server was originally built for Claude Code which has much higher token limits than a free Claude Desktop (non pro or non max). Next version as well should be coming with the edit script feature :slightly_smiling_face:

3 Likes

This is actually so cool!! How’d you even make such a thing?

I’ve been building with Claude Code for the past week or so after swapping from Cursor and my development speed has gone up drastically, although one issue I would consistently run into is Claude not having enough context about stuff other than scripts within the game (i.e UI elements, ScreenGUIs, Parts, Models, Paths, Properties, etc), so I fired up Claude Code once more but instead in this repo and it took only a few hours to build out the basics. From then I’ve just been adding onto it more and more adding functionality when I need it.


I wanted to try to use it, but I get this whevener I try to click the plugin link

Roblox decided to take it down for “Misusing Roblox Systems”. I threw in an appeal but there’s not much else I can do, I’ll change the link to the open source one on GitHub and new users will have to download it from there sadly.

2 Likes

It was likely due to the use of loadstring and setfenv as roblox HATES when you use these functions

Oh, yeah, that’s true. I’m going to look into writing a new version that doesn’t use those functions.

Hopefully you can get this up and running again. I’d love to use this

2 Likes

You can still use it by downloading directly from github

1 Like

Yeah I’m planning on continuing to maintain this whenever I have free-time.

1 Like

Pretty cool so far but I’m getting messages like this frequently. I’m using Claude Desktop btw

“I’m having trouble accessing the source code of the Music script directly through the available tools. The Roblox Studio MCP interface I’m using doesn’t seem to be providing access to the actual script content.”

“The Garages module doesn’t show its source directly. Let me try to access it through the script editor service or check if there are any scripts that import and use this module:”

Sometimes I’ll ask about a specific script and will have no issue accessing it. Then when I ask Claude again about the script, it may say it doesn’t have access.

1 Like

It’s pretty useful, except it doesn’t seem to be able to read the contents of module scripts

Currently this is more designed for Claude Code (agentic CLI made by Anthropic) and other programming agents in combination with Rojo or Argon. I’ve been working the past couple days on implementing a view script source and set script source so you can use this with more general-purpose clients like Claude Desktop and you should expect to see a release of this pretty soon.

edit: made by Anthropic not Claude, mistype

1 Like

v1.5.0 Update - Script Editing is Now Live!

The Studio plugin is back up and working properly (removed loadstring/getfenv for Roblox compliance).

New in v1.5.0:

  • AI can now read and edit your script source code directly
  • Ask things like “Add error handling to this script” or “Fix this memory leak”
  • No more copy-pasting code back and forth

To update: npm i robloxstudio-mcp or just restart the MCP server

The script editing feature makes this much more useful your AI can actually understand and modify your code now.

Edit: Roblox took down the plugin again probably due to the new script editing feature. For now use the open-source Github version.

4 Likes

After updating the MCP plugin is stuck in a waiting loop. Claude Desktop also gets hung up for a long time before saying it failed to connect

I opened an issue on github about this a few days ago, guess all we can do is wait until it’s fixed

Working on a fix for this, also I recommend to re-install by running

npm i robloxstudio-mcp

This will ensure that it’s on the latest version since running npx sometimes will just run the latest local version you have. Should hopefully be a temporary fix for this issue. Another thing you can try doing is disconnecting it and reconnecting a couple times til both the HTTP and MCP are pending then start the MCP server.

1 Like

Working on it! Try running

npm i robloxstudio-mcp

make sure you have node installed as well (already assuming you do). Then restart the server and try to reconnect.

2 Likes