OpenAI Codex (macOS)

Setup for OpenAI Codex

Connect WORKWAY Construction MCP to OpenAI Codex for AI-native construction automation directly from your terminal.

Quick Setup (One Command)

Add WORKWAY to Codex with a single CLI command:

terminal

codex mcp add workway --url https://mcp.workway.co/mcp

This adds WORKWAY as an MCP server that Codex can use for construction workflows.

Manual Configuration

For more control, edit ~/.codex/config.toml:

~/.codex/config.toml

[mcp_servers.workway]
type = "http"
url = "https://mcp.workway.co/mcp"

# For authenticated access (optional)
# bearer_token_env = "WORKWAY_API_KEY"

# Tool configuration (optional)
# tool_allowlist = ["workway_get_action_queue", "workway_list_projects"]
startup_timeout_seconds = 30
tool_timeout_seconds = 60

Configuration Options

bearer_token_env - Environment variable containing your API key
tool_allowlist - Restrict to specific tools
startup_timeout_seconds - Connection timeout
tool_timeout_seconds - Tool execution timeout

Project-Specific Configuration

Create an AGENTS.md file in your project root to give Codex construction-specific context:

AGENTS.md

# Construction Project Agent Configuration

## WORKWAY Integration

This project uses WORKWAY for construction workflow automation.

### Available Capabilities

1. **Command Center** - Prioritized action items across all data sources
   - Use `workway_get_action_queue` to see what needs attention
   - Items are scored by schedule impact, cost impact, and safety risk

2. **Procore Integration** - Direct access to project data
   - RFIs, daily logs, submittals, change orders
   - Use `workway_list_projects` to see available projects

3. **Workflow Automation** - Create automated processes
   - RFI escalation workflows
   - Daily log generation
   - Submittal tracking

### Best Practices

1. Start each day with `workway_get_action_queue` to prioritize
2. For RFI responses, search historical patterns first
3. Before meetings, use `workway_get_project_health` for metrics
4. Flag any safety-related items immediately

AGENTS.md files are discovered automatically

Codex reads AGENTS.md from your project root, giving it context about your construction workflows and preferences.

Security & Approvals

Codex uses smart approvals for MCP tool calls by default. You'll be prompted before:

Creating or modifying workflows
Creating RFIs or change orders in Procore
Deploying workflows to production

Read-only operations like viewing projects, RFIs, and the action queue don't require approval.

Test Your Setup

After configuration, test WORKWAY in Codex:

"Show me what needs attention in my construction projects today"

Codex will use the workway_get_action_queue tool to fetch prioritized items from the Command Center.