Add FactIQ to Codex CLI

Set up

This installs FactIQ for the Codex CLI. If you already installed FactIQ in the ChatGPT desktop app, Codex in the app is covered — only the CLI needs this separate terminal install.

1. 1

   Add the FactIQ marketplace

   codex plugin marketplace add defog-ai/factiq-plugin

   Copy
2. 2

   Add the plugin

   codex plugin add factiq@factiq

   Copy
3. 3

   Sign in to FactIQ

   Finish the browser sign-in. Email, Google, and passkey all work.

   codex mcp login factiq

   Copy
4. 4

   Start a new thread

   The connection applies to new Codex threads, not ones already running.

Try it

Ask a data question normally in a new thread — Codex picks up the FactIQ tools automatically.

• What's the US unemployment rate, charted over the last 10 years?
• Compare US and China CPI inflation year-over-year for the last five years.
• Plot the US 10-year Treasury yield, monthly, since 2020.

Troubleshooting

Marketplace add fails

Confirm the marketplace name is exactly defog-ai/factiq-plugin and that your network allows Codex to reach GitHub.

Login command fails

Make sure the plugin installed successfully first, then re-run codex mcp login factiq.

OAuth gets stuck

Sign in to FactIQ in the same browser, then re-run codex mcp login factiq.

Tools missing in thread

Start a fresh Codex thread after logging in. To remove the plugin later, run codex plugin remove factiq.