Skip to main content
Glama
Roblox Studio MCP Server

Roblox Studio MCP Server

by boshyxd

Archiving project June 6th 2026

Hey a few months ago my laptops motherboard was shorted which contained the hardware keys needed to get into my NPM account, due to Node customer support taking forever and also other priorities taking place for me, I will be archiving this project.

I recommend you swap to https://github.com/Chrrxs/robloxstudio-mcp which is a fork of this one that's being actively maintained by Chrrxs.

Roblox Studio MCP Server

Connect AI assistants like Claude and Gemini to Roblox Studio

NPM Version


What is This?

An MCP server that lets AI explore your game structure, read/edit scripts, and perform bulk changes all locally and safely.

Related MCP server: XenozMCP

Setup

  1. Install the Studio plugin to your Plugins folder

  2. Enable Allow HTTP Requests in Experience Settings > Security

  3. 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

Plugin shows "Connected" when ready.

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

Windows users: If you encounter issues, use cmd:

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

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", "Optimize this movement code"

robloxstudio-mcp-inspector

NPM Version

A lighter, read-only version that only exposes inspection tools. No writes, no script edits, no object creation/deletion. Ideal for safely browsing game structure, reviewing scripts, and debugging without risk of accidental changes.

31 read-only tools: get_file_tree, search_files, get_place_info, get_services, search_objects, get_instance_properties, get_instance_children, search_by_property, get_class_info, get_project_structure, mass_get_property, get_script_source, grep_scripts, get_attributes, get_tags, get_tagged, get_selection, get_playtest_output, get_connected_instances, get_descendants, compare_instances, get_output_log, export_build, list_library, search_materials, get_build, search_assets, get_asset_details, get_asset_thumbnail, preview_asset, capture_screenshot

Setup - same plugin, just swap the package name:

Claude:

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

Codex:

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

Gemini:

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

Windows users: If you encounter issues, use cmd:

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

Report Issues | DevForum | MIT Licensed

Available Tools

24 tools
create_objectA

Create a new Roblox object instance (basic, without properties)

Inputs: className (required), parent (required), name.

create_object_with_propertiesB

Create a new Roblox object instance with initial properties

Inputs: className (required), parent (required), name, properties.

delete_objectB

Delete a Roblox object instance

Inputs: instancePath (required).

get_class_infoB

Get available properties/methods for Roblox classes

Inputs: className (required).

get_file_treeC

Get complete hierarchy of the Roblox Studio project with script types, models, and folders

Inputs: path.

get_instance_childrenC

Get child objects and their types

Inputs: instancePath (required).

get_instance_propertiesC

Get all properties of a specific instance

Inputs: instancePath (required).

get_place_infoA

Get place ID, name, and game settings

Inputs: no named parameters.

get_project_structureB

Get complete game hierarchy. IMPORTANT: Use maxDepth parameter (default: 3) to explore deeper levels of the hierarchy. Set higher values like 5-10 for comprehensive exploration

Inputs: maxDepth, path, scriptsOnly.

get_script_sourceC

Get the source code of a script object (LocalScript, Script, or ModuleScript)

Inputs: instancePath (required).

get_servicesC

Get available Roblox services and their children

Inputs: serviceName.

mass_create_objectsA

Create multiple objects at once (basic, without properties)

Inputs: objects (required).

mass_create_objects_with_propertiesB

Create multiple objects at once with initial properties

Inputs: objects (required).

mass_duplicateC

Perform multiple smart duplications at once

Inputs: duplications (required).

mass_get_propertyA

Get the same property from multiple instances at once

Inputs: paths (required), propertyName (required).

mass_set_propertyB

Set the same property on multiple instances at once

Inputs: paths (required), propertyName (required), propertyValue (required).

search_by_propertyC

Find objects with specific property values

Inputs: propertyName (required), propertyValue (required).

search_filesC

Find files by name, type, or content patterns

Inputs: query (required), searchType.

search_objectsB

Find instances by name, class, or properties

Inputs: query (required), propertyName, searchType.

set_calculated_propertyC

Set properties using mathematical formulas and variables

Inputs: formula (required), paths (required), propertyName (required), variables.

set_propertyC

Set a property on any Roblox instance

Inputs: instancePath (required), propertyName (required), propertyValue (required).

set_relative_propertyB

Modify properties relative to their current values

Inputs: operation (required), paths (required), propertyName (required), value (required), +1 more.

set_script_sourceA

Safely set the source code of a script object without using loadstring (Studio only)

Inputs: instancePath (required), source (required).

smart_duplicateC

Smart duplication with automatic naming, positioning, and property variations

Inputs: count (required), instancePath (required), options.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 24 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between 'create_object' and 'create_object_with_properties', and between 'mass_create_objects' and 'mass_create_objects_with_properties', which could cause confusion. However, descriptions clarify the differences, and other tools like 'search_objects' vs 'search_by_property' are well-differentiated.

    Naming Consistency5/5

    Tool names follow a consistent snake_case pattern with clear verb_noun structures (e.g., 'create_object', 'get_instance_properties', 'set_script_source'). There are no deviations in naming conventions, making the set predictable and easy to parse.

    Tool Count3/5

    With 24 tools, the count is on the higher side for a single domain, which may feel heavy and could overwhelm agents. While the tools cover many aspects of Roblox Studio, some could potentially be consolidated (e.g., the multiple 'mass_' tools) to reduce complexity.

    Completeness5/5

    The tool set provides comprehensive coverage for Roblox Studio operations, including CRUD for objects (create, delete, get, set), property management, scripting, searching, and project hierarchy exploration. No obvious gaps are present; agents can perform full lifecycle management and complex workflows.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to control Roblox Studio by running Luau code, creating and editing instances, reading the scene tree, and managing scripts via an MCP server with a long-polling plugin bridge.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to interact with Roblox Studio via a token-efficient MCP server, live two-way script sync, and zero-friction plugin setup.
      -