Add FactIQ to Claude Code

Set up: local sessions

One install from any terminal covers the CLI, the desktop app, and IDE extensions on your machine.

1. 1

   Add the FactIQ marketplace

   claude plugin marketplace add defog-ai/factiq-plugin

   Copy
2. 2

   Install the plugin

   claude plugin install factiq@factiq

   Copy
3. 3

   Reload and select FactIQ

   In Claude Code, run /reload-plugins, then /mcp and select factiq.

4. 4

   Connect your FactIQ account

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

Set up: cloud sessions (web or desktop)

Cloud sessions run on Anthropic infrastructure and don’t see plugins installed on your machine. Enable FactIQ per repository instead.

1. 1

   Declare the plugin in your repo

   Add this to the repository's checked-in .claude/settings.json:

   {
     "extraKnownMarketplaces": {
       "factiq": {
         "source": { "source": "github", "repo": "defog-ai/factiq-plugin" }
       }
     },
     "enabledPlugins": { "factiq@factiq": true }
   }

   Copy
2. 2

   Start a cloud session in that repo

   The plugin installs at session start. Complete the FactIQ sign-in when prompted.

Try it

Ask a data question normally, or run /factiq:ask <question> to force the full FactIQ workflow.

• 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 Claude Code to reach GitHub.

factiq missing from /mcp

Run /reload-plugins again, or restart Claude Code, then re-run /mcp.

OAuth gets stuck

Sign in to FactIQ in the same browser, then re-run /mcp and select factiq again.

Tools missing in session

FactIQ is enabled per session. Run /mcp and confirm factiq shows as connected. To remove it later, run claude plugin uninstall factiq.

Installed in the Claude app instead?

Claude and Claude Code plugins are separate systems — installing FactIQ in Claude chat doesn’t make it available in Claude Code, or the other way around.