Ask Claude about your marketing performance and get answers from the same data behind your Headlight dashboards. The Headlight connector gives Claude read-only access to your company’s Headlight analytics, so you can ask questions in plain language instead of building reports.

Who can use it

Anyone with a Headlight client portal account, for clients where Headlight has turned the connector on. If you work with more than one Headlight client, one connection covers all of them. Ask your Headlight contact to turn it on.

Connect

  1. In Claude, open Settings → Connectors, find Headlight and click Connect.
  2. Sign in with your Headlight client portal email, password and second factor.
  3. Approve access. You’re returned to Claude.

In Claude Code: claude mcp add --transport http headlight https://mcp.headlight.co/mcp, then /mcp → Authenticate.

What you can ask

  • “Which of my clients can I look at in Headlight?”
  • “What was our spend and ROAS by channel over the last 30 days?”
  • “Find our weekly performance dashboard and summarise what changed.”
  • “Which campaigns had the highest cost per acquisition last month?”

Claude finds the right dataset, picks its fields and runs the query. Each answer includes a link to open the same data in Looker.

What it can do

  • List clients: the clients you can query, and whether each is ready
  • List explores: the datasets available for a client
  • Describe explore: a dataset’s dimensions, measures and filters
  • Run query: runs a query on a dataset and returns the rows
  • Search content: finds saved Looks and dashboards by title
  • Run Look: returns a saved Look’s rows
  • Get dashboard: a dashboard’s title, filters and tiles
  • Run dashboard tile: returns one dashboard tile’s rows

Every tool is read-only: the connector can’t create, change or delete anything. You only see the clients your portal account belongs to.

Troubleshooting

  • “Being set up”: access for a client is set up the first time it’s used, which takes a few minutes. Other clients work meanwhile.
  • A client is missing: the connector isn’t turned on for it, or your portal account doesn’t include it. Ask your Headlight contact.
  • A query times out: ask for fewer fields or a shorter date range.
  • Sign-in fails: check you can sign in at clients.headlight.co, then disconnect and reconnect in Claude.

Privacy and support

See our Claude Connector Privacy Policy. Support: contact@headlight.co.