How to use Roblox MCP with OpenAI Codex CLI (terminal-based AI coding tool).
Prerequisites
- Node.js (v18.0.0 or higher)
- Roblox Studio plugin installation complete
Installation
npm install -g @openai/codex
Registering the MCP Server
Method 1: CLI Command (Recommended)
codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp
Method 2: Edit Config File Directly
Add the following to your ~/.codex/config.toml file:
[mcp_servers.weppy-roblox-mcp]
command = "npx"
args = ["-y", "@weppy/roblox-mcp"]
Config file location:
| OS | Path |
|---|---|
| macOS/Linux | ~/.codex/config.toml |
| Windows | %USERPROFILE%\.codex\config.toml |
Connection Test
- Launch Roblox Studio → Plugins tab → WEPPY → Connect
- Run Codex CLI and enter:
Tell me what is currently selected in Roblox Studio
Troubleshooting
Server Won’t Start
Run the MCP server directly to see the error:
npx -y @weppy/roblox-mcp
Connection Fails
- Confirm the Roblox Studio plugin shows Connected status
- Check that port 3002 is not blocked by a firewall