roblox-mcp-windows

Roblox MCP Plugin Marketplace

Claude plugins for Roblox Studio via MCP. Pick the plugin for your OS and install it in the Claude product you're using.

Plugins

Plugin	Platform	MCP server path
roblox-mcp-windows	Windows	%LOCALAPPDATA%\Roblox\mcp.bat
roblox-mcp-mac	macOS	~/Library/Application Support/Roblox/mcp.sh

Each plugin ships the same three skills: Luau Scripting & Debugging, Edit-Time vs Play-Time Operations, and Roblox Game Architecture.

---

Installation

There are three ways to install, depending on which Claude product you use.

1. Marketplace URL (Claude Code + Claude Desktop / Cowork)

This is the simplest method. Once the repo is on GitHub, users add the marketplace by URL and install individual plugins from it.

Claude Code:

# Add the marketplace (one-time)
/plugin marketplace add your-username/roblox-mcp-marketplace

# Install the plugin for your platform
/plugin install roblox-mcp-windows@roblox-mcp    # Windows
/plugin install roblox-mcp-mac@roblox-mcp         # macOS

# Update all marketplace plugins later
/plugin marketplace update

Claude Desktop / Cowork:

Go to Settings → Plugins → Add plugin → GitHub, enter your-username/roblox-mcp-marketplace, and install the plugin for your platform.

Replace your-username/roblox-mcp-marketplace with the actual GitHub owner/repo.

---

2. File picker — .plugin file (Claude Desktop only)

Claude Desktop can also install plugins from a zipped .plugin file. Build it first, then use the file picker.

Windows:

cd roblox-mcp-windows
build.bat

→ Settings → Plugins → Install plugin → select roblox-mcp-windows\dist\roblox-mcp-windows.plugin

macOS:

cd roblox-mcp-mac
chmod +x build.sh && ./build.sh

→ Settings → Plugins → Install plugin → select roblox-mcp-mac/dist/roblox-mcp-mac.plugin

---

3. --plugin-dir (Claude Code only)

Claude Code can load a plugin directly from a directory — no build step needed.

claude --plugin-dir ./roblox-mcp-windows   # Windows
claude --plugin-dir ./roblox-mcp-mac       # macOS

---

Quick Reference

Method	Product	Build step?	How
Marketplace URL	Claude Code	No	/plugin marketplace add owner/repo → /plugin install roblox-mcp-windows@roblox-mcp
Marketplace URL	Claude Desktop / Cowork	No	Settings → Plugins → Add plugin → GitHub → owner/repo
.plugin file	Claude Desktop	Yes (build.bat / build.sh)	Settings → Plugins → Install plugin → select .plugin file
--plugin-dir	Claude Code	No	claude --plugin-dir ./roblox-mcp-windows

---

Build All Plugins

To build .plugin zip files for both platforms at once:

Windows (CMD / PowerShell):

build.bat

macOS / Linux / WSL:

chmod +x build.sh && ./build.sh

---

Prerequisites

Roblox Studio must be installed and open before starting a session. The MCP server (mcp.bat on Windows, mcp.sh on macOS) is bundled with recent Studio versions.

• Roblox Studio MCP Docs