DocsDocs
Open app

Codex

Access your Doow workspace from Codex.

3 min readUpdated 2026-09-07

Codex is OpenAI's coding agent, available in the CLI and desktop app. Adding Doow lets Codex manage your workspace through natural language.

Add the server with the Codex CLI

bash
codex mcp add doow --url https://mcp.doow.co

Codex registers the server and stores the configuration.

Add the server in the desktop app

The ChatGPT desktop app shares MCP server configuration with the Codex CLI and IDE extension. To add Doow in Codex:

  1. Open Codex from the top-left menu.
  2. Open Settings and select MCP servers.
  3. Select Add server.
  4. Enter doow, choose Streamable HTTP, and enter https://mcp.doow.co.
  5. Save the server and select Restart.
  6. Select Authenticate when the server requires sign-in.

Type /mcp in the composer to view connected servers. A server added in the desktop app is also available to the Codex CLI and IDE extension through the shared Codex configuration.

First use

When you first use a Doow tool, Codex opens your browser to authenticate:

  1. Sign in with your Doow account
  2. Grant access to your workspace
  3. Return to Codex

After authentication, Codex can access your Doow workspace.

CLI modes: interactive vs non-interactive

Codex has two modes that affect how Doow tools work:

Interactive session (default)

bash
codex
  • Full access to all 85 tools
  • Confirmation prompts appear in your terminal
  • Protected operations work normally

Non-interactive (codex exec)

bash
codex exec "list my apps"
  • Read-only tools work normally
  • Protected operations fail with ELICITATION_DENIED
  • Use for queries and reports, not mutations

Example session

Example conversation
You
What's my SaaS spend this quarter?
Codex
[calls doow_dashboard_spend]
Q3 2026 spend: $127,400
- Top category: Engineering ($52,300)
- Top app: GitHub ($15,600)
- Renewal risk: 3 contracts expiring without review
You
Show me those expiring contracts
Codex
[calls doow_contracts_renewals_metrics]
3 contracts expiring without review:
1. Datadog - expires Sep 30 - $24,000/year
2. PagerDuty - expires Oct 15 - $8,400/year
3. LaunchDarkly - expires Oct 20 - $12,000/year
You
Deactivate the PagerDuty app
Codex
[calls doow_apps_deactivate]
⚠️ Confirm deactivation of PagerDuty?
This marks the app as inactive in your inventory.
[y/N]
You
y
Codex
PagerDuty has been deactivated.

Scopes

Codex requests both mcp:read and mcp:write by default.

CLI session cleanup

When you exit the Codex CLI, it sends DELETE /mcp with the Mcp-Session-Id header. Doow returns 204 and removes the session. Sessions also expire after 60 minutes of inactivity.

Remove the server

bash
codex mcp remove doow

Troubleshooting

  1. "ELICITATION_DENIED" error

    You are running a protected operation in non-interactive mode. Start an interactive session:

    bash
    codex

  2. "Authentication failed"

    • Confirm you can sign in at app.doow.co
    • Check that your organization is active
    • Remove and re-add the server:
      bash
      codex mcp remove doowcodex mcp add doow --url https://mcp.doow.co

  3. Tool returns empty results

    Your Doow role may not have access to those resources. Admins see all resources, while App Admins, Integration Admins, and Department Admins see only their assigned resources.

Next steps

OAuth reference

Understand the authentication flow.

Scopes

Learn what each scope grants access to.

Troubleshooting

Troubleshoot common errors.

Was this page helpful?