WEPPY

Codex CLI Setup

How to use Roblox MCP with Codex CLI.

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

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:

OSPath
macOS/Linux~/.codex/config.toml
Windows%USERPROFILE%\.codex\config.toml

Connection Test

  1. Launch Roblox Studio → Plugins tab → WEPPYConnect
  2. 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