Roblox Studio MCP Server
The Roblox Studio MCP Server enables AI assistants to deeply interact with Roblox Studio projects through 22 specialized tools for analysis, manipulation, and bulk operations:
Project Navigation: Explore hierarchies (
get_file_tree), analyze game architecture (get_project_structure), and get place information (get_place_info)Search Capabilities: Find files (
search_files), objects (search_objects), or instances with specific property values (search_by_property)Instance Management: Create (
create_object), delete (delete_object), and get children (get_instance_children) of objectsProperty Handling: View (
get_instance_properties), set (set_property), and manipulate properties with formulas (set_calculated_property,set_relative_property)Bulk Operations: Perform mass creation (
mass_create_objects), duplication (mass_duplicate), and property setting (mass_set_property) with atomic undo/redo supportAdvanced Features: Access class information (
get_class_info), services (get_services), and smart duplication with automatic naming and positioning (smart_duplicate)
Provides AI tools access to Roblox Studio data, including file system operations, studio context information, property and instance management, and project structure analysis through a plugin-based architecture.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Roblox Studio MCP Server show me all scripts in the Workspace folder"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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
Install the Studio plugin to your Plugins folder
Enable Allow HTTP Requests in Experience Settings > Security
Connect your AI:
Claude Code:
claude mcp add robloxstudio -- npx -y robloxstudio-mcp@latestCodex CLI:
codex mcp add robloxstudio -- npx -y robloxstudio-mcp@latestGemini CLI:
gemini mcp add robloxstudio npx --trust -- -y robloxstudio-mcp@latestPlugin 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
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@latestCodex:
codex mcp add robloxstudio-inspector -- npx -y robloxstudio-mcp-inspector@latestGemini:
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 toolscreate_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
Scored across 24 tools
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.
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.
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.
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
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Gives AI agents direct access to your Sanity projects and guidance for working with them
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to Roblox Studio, enabling them to interact with instance hierarchy, edit Luau scripts, manage properties, and sync files over a local connection.16 npm2MIT
- FlicenseAqualityCmaintenanceAn MCP server that bridges AI to Roblox Studio, enabling execution of Luau scripts, instance manipulation, play-testing control, and Open Cloud operations via natural language.221-
- AlicenseNot gradedqualityAmaintenanceEnables 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
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to interact with Roblox Studio via a token-efficient MCP server, live two-way script sync, and zero-friction plugin setup.-