How to Connect PostHog to Claude Code

Query your PostHog data directly from Claude Code using Sequel’s MCP server. Ask questions in plain English, with no SQL, no dashboards, and no context switching.

Short answer

Connect PostHog to Sequel, then add Sequel's MCP server to Claude Code using the config on this page. Claude Code can then query your live PostHog data in plain English, with no connector code and no CSV exports. Both steps take a few minutes.

Example prompts

Everything you can ask Claude Code about your PostHog data.

Ask in plain English — Sequel translates it into a PostHog query, runs it, and Claude Code hands back the answer. No SQL, no dashboards, no CSV exports.

Connect to your agent
What you can ask Claude Code
  • How many unique users triggered $pageview yesterday, by country?
  • Show me the signup → activation funnel for users created in the last 30 days.
  • What's the 7-day retention of users in the 'Power users' cohort?
  • Which 10 feature flags have the most evaluations this week?
  • Compare conversion rate by browser for the checkout funnel.

How it works

Three steps to get started

1

Connect PostHog to Sequel

In your Sequel dashboard, go to Connections and add PostHog. Sequel handles authentication and schema discovery automatically.

2

Add Sequel to the agent

Copy the Sequel MCP configuration into Claude Code's settings file (shown below). Swap in your API key from Settings → API Keys.

3

Ask Claude Code about your data

Restart Claude Code and start asking questions. "How many unique users triggered $pageview yesterday, by country?" — and get a real answer backed by live PostHog data.

Configuration

Add Sequel to Claude Code

Place this in claude mcp add (CLI) and replace sql_your_api_key with a key from Settings → API Keys.

claude mcp add (CLI)

claude mcp add --transport http sequel https://api.sequel.sh/mcp \
  --header "Authorization: Bearer sql_your_api_key"

Install

Install PostHog MCP in Claude Code

Pick your app and Sequel installs itself: a one-click link where the client supports it, that client’s own few steps where it doesn’t. Every route signs in with your Sequel account over OAuth, so there is no API key to copy and nothing to keep in sync.

Already have an MCP client?

https://api.sequel.sh/mcp

Add it as a remote (streamable HTTP) server and sign in when prompted. Skills come with it; nothing else to install. Manual setup per client

Add Sequel to Claude Code

Terminal

claude mcp add --transport http sequel https://api.sequel.sh/mcp
  1. 1Run the command in your terminal. It adds Sequel to the current project; add --scope user for every project.
  2. 2Start Claude Code and run /mcp. Choose sequel and sign in in the browser.
  3. 3Ask a question. Claude Code asks your permission the first time it calls a tool.

Frequently asked questions

How do I connect PostHog to Claude Code?

You need two things: (1) connect PostHog to Sequel in your Sequel dashboard under Connections, and (2) add the Sequel MCP config to Claude Code using the setup shown above. Once both are done, Claude Code can query your PostHog data directly.

What PostHog data can Claude Code access?

Claude Code can access any data available through your PostHog connection in Sequel. Use Sequel's search tool to discover available metrics and dimensions, then execute queries to pull the data you need.

Is my PostHog data sent to Claude Code's servers?

Query results are returned to Claude Code as context within your conversation. Only the data you explicitly ask about is retrieved. Sequel never stores your query results permanently — they exist only for the duration of the tool call.

Do I need a Sequel account?

Yes. You need a Sequel account to connect PostHog and generate an API key. Sign up free at sequel.sh — no credit card required. Then create a connection to PostHog and generate an API key from Settings → API Keys.

Can I connect multiple PostHog accounts?

Yes. Sequel supports multiple connections of the same type. If you have multiple PostHog accounts or properties, add each as a separate connection in Sequel. Claude Code will be able to query all of them.

Connect PostHog to Claude Code today

Sign up free, connect your data sources, and start querying in minutes.