[v1.6] Roblox Studio MCP Server - Speed up your workflow by letting AI read and edit your scripts directly

[BoshyDx (boshy)]

Star on GitHub for updates

Download | GitHub | NPM Package | Documentation

Connect AI assistants like Claude to your Roblox Studio projects

20+ tools for project analysis, script editing, and bulk operations

---

What is This?

An MCP server that connects AI assistants (like Claude) to Roblox Studio through a local bridge and plugin. It lets AI explore your game’s structure, read and edit scripts (including ModuleScripts), and perform safe, bulk changes, all locally.

---

Quick Setup

Step 1: Install the Studio plugin (from Releases or your preferred method)

Step 2: Enable “Allow HTTP Requests” in Game Settings → Security

Step 3: Connect your AI assistant:

# Claude Code
claude mcp add robloxstudio -- npx -y robloxstudio-mcp

# Claude Desktop - add to config
{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "npx",
      "args": ["-y", "robloxstudio-mcp"]
    }
  }
}

Updating from older versions or fixing cache issues:

npm i robloxstudio-mcp

The plugin shows “Connected” when ready.

What Can You Do?

Project understanding:  "What's the structure of this game?"
Debugging:            "Find possible memory leaks or deprecated APIs"
Mass operations:      "Create 50 test NPCs and position them in a grid"
Script work:          "Explain this weapon system" / "Optimize this movement code"

Why Use This?

• Understand and navigate large projects quickly
• Apply consistent changes at scale (properties, duplication, creation)
• Read and edit script sources programmatically and safely via Studio

Key Features

• Project analysis and search across services, objects, and scripts
• Script management (read/write) for Script, LocalScript, and ModuleScript
• Mass operations (property edits, smart/mass duplication, calculated/relative properties)

Complete Tool List (20+ tools)

Analysis & Search: get_project_structure, search_objects, search_files, search_by_property

Properties: get_instance_properties, set_property, mass_set_property, mass_get_property

Creation: create_object, mass_create_objects, smart_duplicate, mass_duplicate

Scripts: get_script_source, set_script_source

Advanced: set_calculated_property, set_relative_property, get_class_info

Security

• 100% local: runs on your machine
• Localhost-only bridge (default: 3002)
• You approve changes in Studio

---

Latest Updates

v1.6.0

• ModuleScript support (Script, LocalScript, ModuleScript)
• Content search includes ModuleScripts
• set_property supports Source on any LuaSourceContainer
• HTTP parity: /mcp/get_script_source, /mcp/set_script_source

---

Get Started

1. Install Studio Plugin
2. Enable HTTP Requests (Game Settings → Security)
3. Connect AI: claude mcp add robloxstudio -- npx -y robloxstudio-mcp

Ready in under 2 minutes.

Try asking: “What’s the structure of this game?” or “Find all scripts with potential issues”

Links & Resources

Documentation • Report Issues • Request Features • NPM Package

---

MIT Licensed • Free for any use • Built for the Roblox developer community

[artembon (baj)]

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.

[BoshyDx (boshy)]

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

[TIMMY12_YT (smallFrie)]

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

[BoshyDx (boshy)]

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.

[winpol (winpo1)]

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

[BoshyDx (boshy)]

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.

[GetStyled]

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

[BoshyDx (boshy)]

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

[Dued1]

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

[artembon (baj)]

You can still use it by downloading directly from github

[BoshyDx (boshy)]

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

[Dued1]

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.

[wShadowRBLX (coatmol)]

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

[BoshyDx (boshy)]

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

[BoshyDx (boshy)]

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.

[Dued1]

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

[artembon (baj)]

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

[BoshyDx (boshy)]

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.

[BoshyDx (boshy)]

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.