Connect PostHog MCP to your AI Agents

Ask your PostHog product data anything — with HogQL under the hood.

Example prompts

Everything you can ask your agent about your PostHog data.

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

Connect to your agent
What you can ask your agent
  • 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.

Install

Install PostHog MCP in your agent

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.

Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex, Grok, Muse, dots and any other MCP app

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

Choose your app

  • Claude

    One click, opens in the app

  • Cursor

    One click, opens in the app

  • VS Code

    One click, opens in the app

  • ChatGPT

    Turn on developer mode, then add Sequel. About two minutes.

  • Claude Code

    Run one command, then sign in with /mcp.

  • Codex

    Run one command, then sign in.

  • Gemini CLI

    Run one command, then sign in with /mcp auth.

  • Grok

    Add Sequel as a connector and sign in.

  • Grok Bot

    Paste this to the bot. It registers Sequel and asks you to sign in.

  • Muse

    Muse writes its own connector. One message is the whole setup.

  • dots

    Add Sequel in ChatGPT; your dot picks it up with no extra step.

  • OpenCode

    Add Sequel as a remote server from the OpenCode CLI.

  • Other MCP app

    Any client that speaks remote MCP can connect with this URL.

Skills

Playbooks that run on PostHog

Step-by-step procedures your agent follows on your PostHog data, instead of improvising a query. Browse all skills

Can we trust our product metrics

Two tools show different numbers for the same metric and nobody knows which to trust. Reconciles the disputed figure against a system of record such as Stripe or the application database, then finds the instrumentation defect behind it: duplicate and near-duplicate event names, events that silently stopped firing, missing properties and system-fired events counted as user actions.

Failed payment and involuntary churn audit

Separate customers who chose to leave from cards that simply declined: failed payments, declined renewals and involuntary churn, and where in the dunning and retry sequence the recovery is being lost. Covers involuntary churn share, first-attempt failure rate, payment recovery rate, decline codes and which accounts are sitting in dunning right now.

Feature launch impact readout

Measure whether a feature we just shipped actually landed: adoption against an eligible denominator of users who could even reach it, breadth, depth and sustained use after the release, a pre and post impact estimate with or without a control group, and a keep, iterate or sunset call.

Find our activation moment

Discover the aha moment: which early in-product action, taken in the first session or first week, most separates users who stay from users who vanish, how to score candidate first actions by retention lift, and what share of new signups ever reach it. Covers activation metric definition, activation rate and time to value.

Is our retention curve flattening

Do users keep coming back, or do they drift away after the first week or month? Builds the cohort retention curve for your key action at its natural frequency and judges whether it flattens to a plateau or decays to zero, covering N-day versus unbounded retention, repeat usage, leaky bucket diagnosis and how the plateau compares to published benchmarks.

Product qualified lead handoff list

Build a ranked list of self-serve accounts sales should contact this week: join product usage to CRM and billing, exclude accounts already paying or already in an open deal, and attach the named trigger event and the evidence for each row.

Frequently asked questions

How do I connect PostHog to Sequel?

Create a Personal API Key in PostHog under Settings → Personal API Keys with read-only scopes: query:read, event_definitions:read, property_definitions:read, insight:read, cohort:read, project:read. Paste it into Sequel along with your host (US Cloud, EU Cloud, or self-hosted base URL) and your numeric project ID, then click Test.

Does Sequel work with PostHog Cloud and self-hosted PostHog?

Both. For PostHog Cloud, use https://us.posthog.com or https://eu.posthog.com. For self-hosted, point the host field at your own base URL (no trailing slash) — as long as the same Personal API Key endpoints exist, Sequel works identically.

What is HogQL, and why does it matter?

HogQL is PostHog's SQL dialect that runs against the raw events table. It's strictly more expressive than the insight builder — joins, window functions, conditional aggregations. Sequel writes HogQL under the hood, which is why it can answer questions a built-in insight can't.

Can Sequel write or change anything in PostHog?

No. The connector only ships read-only tools (HogQL query, list events, list properties, list insights, list cohorts) and works with read-only scopes. The agent cannot create insights, dashboards, cohorts, or feature flags.

Does Sequel see session replays or autocapture content?

Sequel can query session metadata and event names — including autocapture events — but does not download replay videos or full DOM snapshots. Replays stay where they belong: in PostHog's UI.

How fresh is the data?

Queries hit the PostHog API at the moment you ask, so freshness matches HogQL's own freshness — typically seconds to a minute behind ingest. The Person table follows PostHog's standard person-merge semantics.

Does Sequel store my PostHog data?

No. Query results are returned to your session and discarded; only your Personal API Key is stored, encrypted at rest with AES-256-GCM. You can rotate or revoke the key from PostHog Settings at any time.

Can I combine PostHog with other data sources?

Yes. The most common combos are PostHog + Postgres (behavior vs. accounts), PostHog + Stripe (behavior vs. revenue), and PostHog + GA4 (product vs. acquisition). Sequel reasons across all of them in a single question.

Will rate limits ever throttle my questions?

PostHog enforces per-project HogQL concurrency and request-rate limits. Sequel queues and respects them; large fan-out questions will sometimes pause briefly rather than fail. If you hit limits often, contact PostHog support or upgrade your plan.

Start analyzing your PostHog data today

Connect in minutes — then ask across all your data, not just one source.