Codex Setup 

Connect AI Tools to your Headset data. Once connected, you can ask questions in plain English ("How did flower sales trend over the last 8 weeks?", "Which SKUs are about to stock out?") and the AI pulls live answers straight from your Headset account.
 

The Headset MCP server uses the Model Context Protocol (MCP), an open standard that lets AI assistants securely call tools on your behalf. Everything is read-only: the AI can query your data, but it can never change anything in Headset.

What you'll need

• A Headset account with an active Retailer, Bridge, or Insights subscription. The tools you see after connecting match your subscription, so a Retailer user sees the retailer tool set, a Bridge user sees the bridge tool set, and users with both see both.

---------------------------------------------------------------------------------------------------------------

 

1. Give Codex this instruction in any chat. It writes the server into its own config and kicks off the login for you.

   Instruction for Codex: 
   
   "Set up the Headset MCP server for me. Run `codex mcp add headset --url https://mcp.headset.io`, let me know when the browser opens so I can sign in to Headset, then check `codex mcp list` and tell me whether Headset is connected."
    

2. Sign in to Headset when Codex opens the login in your browser.
    

3. Rather drive it yourself? The registration is a single command, and codex mcp login headset starts the login again if access is ever revoked.

   
   Terminal command:
   codex mcp add headset --url https://mcp.headset.io