Weppy Roblox MCP WEPPY

WEPPY

Codex CLI Setup

How to use the WEPPY Roblox AI Toolkit and Roblox MCP with Codex CLI.

How to use the WEPPY Roblox AI Toolkit and Roblox MCP with OpenAI Codex CLI (terminal-based AI coding tool).

Codex plugins can bundle skills, app integrations, and MCP server settings. WEPPY ships as a Codex plugin with the MCP server config and Roblox Studio workflow skills, so installing the plugin first is recommended over manual MCP setup.

Prerequisites

  • Node.js (v18.0.0 or higher)
  • Codex CLI installed
  • Roblox Studio plugin installation complete

Install Codex CLI

npm install -g @openai/codex

If it is already installed, update it to the latest version:

codex update

Add the WEPPY plugin marketplace from your terminal:

codex plugin marketplace add hope1026/weppy-roblox-mcp

Then reopen Codex CLI and open the plugin list:

codex
/plugins

Select WEPPY Roblox AI Toolkit from the added WEPPY marketplace and run Install plugin.

After installation, start a new conversation. The plugin adds the npx -y @weppy/roblox-mcp@latest MCP server config together with WEPPY skills. If needed, use @ in a prompt to target a plugin or bundled skill, or use /skills or $ to find and invoke installed skills.

Method 2: Register Only the MCP Server Manually

Use this only if you want the MCP server without WEPPY skills. If you installed the plugin with Method 1, you can skip this step.

CLI Command

codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp@latest

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@latest"]

Config file location:

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

Connection Test

  1. Launch Roblox Studio → Plugins tab → WEPPY → Connect
  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@latest

WEPPY Plugin Does Not Appear in the List

Refresh the marketplace, then restart Codex:

codex plugin marketplace upgrade hope1026-roblox-mcp

Connection Fails

  • Confirm the Roblox Studio plugin shows Connected status
  • Check that port 3002 is not blocked by a firewall