Codex CLI

Codex reads its bearer tokens from environment variables rather than the config file. So setup is two steps: export the token, then point Codex at Hourdini.

What you'll need

• Codex CLI installed and authenticated.
• A Hourdini Personal Access Token. Generate one at /cli/connect, and copy it now.

Step 1: Export the token

Add this to your shell profile (~/.zshrc, ~/.bashrc, etc.):

export HOURDINI_PAT="hd_pat_live_••••"

Replace with your actual token. Reload your shell or open a new tab.

Step 2: Add the server

Either use the codex mcp add shortcut:

codex mcp add hourdini \
  --url https://hourdini.app/api/mcp/mcp \
  --bearer-token-env-var HOURDINI_PAT

Or hand-edit ~/.codex/config.toml:

[mcp_servers.hourdini]
url = "https://hourdini.app/api/mcp/mcp"
bearer_token_env_var = "HOURDINI_PAT"

Step 3: Try it

Start a Codex session and ask:

Show me my unbilled hours for Acme this month.

Codex should call get_unbilled_time and reply with the totals.

For more, see the FAQ.