Roblox Studio MCP for Claude Code

A complete setup guide and configuration for integrating Roblox Studio with Claude Code using the Model Context Protocol (MCP). This enables direct manipulation of Roblox Studio from Claude Code through programmatic tools.

🎯 What This Enables

With this setup, Claude Code can directly:

• ✅ Create RemoteEvent and RemoteFunction objects in Roblox Studio
• ✅ Generate and insert ModuleScript, Script, and LocalScript objects
• ✅ Execute Lua code directly in Roblox Studio
• ✅ Insert models and manipulate the Studio workspace
• ✅ Build complete Roblox games programmatically
• ✅ Automate game development workflows

🚀 Quick Start

Prerequisites

• Roblox Studio installed and running
• Claude Code CLI installed
• Rust and Cargo (for building the MCP server)
• Linux/WSL environment (tested on Ubuntu)

1. Clone and Build MCP Server

# Clone the official Roblox Studio MCP server
git clone https://github.com/Roblox/studio-rust-mcp-server.git
cd studio-rust-mcp-server

# Install required dependencies
sudo apt update && sudo apt install -y pkg-config libssl-dev

# Build the MCP server
cargo build --release

# The binary will be at: target/release/rbx-studio-mcp

2. Build and Install Studio Plugin

# Install Rojo (Roblox project management tool)
cargo install rojo

# Build the plugin
cd plugin
rojo build --output MCPStudioPlugin.rbxmx

# Install in Roblox Studio:
# Method A: Plugins → Manage Plugins → Install Plugin → Select MCPStudioPlugin.rbxmx
# Method B: Copy to %LOCALAPPDATA%\Roblox\Plugins\ (Windows) or ~/Documents/Roblox/Plugins/ (macOS)

3. Configure Claude Code

Create an MCP configuration file:

{
  "mcpServers": {
    "roblox-studio": {
      "command": "/path/to/studio-rust-mcp-server/target/release/rbx-studio-mcp",
      "args": ["--stdio"],
      "description": "Roblox Studio MCP Server for direct Studio integration"
    }
  }
}

4. Start Claude Code with MCP

# Start Claude Code with the MCP configuration
claude --mcp-config path/to/mcp-config.json

5. Test the Integration

Once both Roblox Studio (with plugin) and Claude Code (with MCP) are running:

Ask Claude Code: "Use the Roblox MCP tools to create a simple 'Hello World' script in ServerScriptService"

📁 Repository Contents

├── README.md                          # This file
├── SETUP_GUIDE.md                     # Detailed setup instructions
├── claude-code-mcp-config.json        # MCP configuration template
├── docs/                              # Documentation
│   ├── MCP_TOOLS.md                   # Available MCP tools reference
│   ├── TROUBLESHOOTING.md            # Common issues and solutions
│   └── BEST_PRACTICES.md             # Development best practices
└── scripts/                          # Utility scripts
    ├── install.sh                     # Automated installation script
    └── test-connection.sh             # MCP connection test script

🛠️ Available MCP Tools

Once connected, Claude Code has access to these Roblox Studio tools:

• mcp__roblox_studio__run_code - Execute Lua code in Studio
• mcp__roblox_studio__insert_model - Insert models into workspace
• Additional tools for workspace manipulation

🎮 What You Can Build

With the MCP setup, you can ask Claude Code to create entire games:

"Create a complete tower defense game with:
- Enemy spawning system
- Tower placement mechanics  
- Upgrade system
- Wave progression
- Player economy
- Leaderboard system"

Claude Code will:

1. Create the proper folder structure in Roblox Studio
2. Generate all scripts with correct object types
3. Set up RemoteEvents for client-server communication
4. Insert the code directly into Studio
5. Configure the complete game systems

📚 Documentation

• Detailed Setup Guide - Step-by-step installation
• MCP Tools Reference - Complete tools documentation
• Troubleshooting - Common issues and fixes
• Best Practices - Development recommendations

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests for any improvements.

📄 License

This project builds upon the official Roblox Studio MCP Server and follows the same licensing terms.

🔗 Related Projects

• Official Roblox Studio MCP Server
• Claude Code
• Model Context Protocol
• Rojo - Roblox Project Management

⭐ Star This Repository

If this helped you set up Roblox Studio with Claude Code, please give it a star! ⭐

---

Made with ❤️ for the Roblox development community