Skip to content
All connectors
PostHog MCP server · Analytics

Ask your AI what people do in your product

PostHog records what people actually do in your product, event by event. This connector lets you ask it from your own AI assistant without writing a query: how many people signed up last week, where they leave the onboarding funnel, and what the saved retention insight says today.

Connect PostHog to Claude, ChatGPT, Grok, Perplexity, Claude Code, Codex, Cursor or Antigravity, with one connection, on the subscription you already pay for.

Your accounts
  • PostHog
  • Search Console
  • Stripe
  • Jira
HeyMetra
Your AI assistant
Claude
How many people signed up last week, and where did they drop out of onboarding?
Read PostHog with HeyMetra
612 people signed up; 38% stopped at “connect your data”, the same step as the week before. That step is where most new users are lost.
Reply to Claude…

Read-only until you allow changes, and every change waits for your approval.

What you can ask it

Without HeyMetra

Claude
Which search landing pages turn visitors into sign-ups best?
I can’t see your PostHog and Google Search Console. Download the landing-page funnel and Search Console’s pages report and paste it here, and I’ll work it out.

With HeyMetra

Claude
Which search landing pages turn visitors into sign-ups best?
Read with HeyMetra
/compare/sheets converts 6.2% of search visitors, three times the average, but gets only 410 clicks.
Make this a PDF and email it to the team every Monday at 9:00.
  • report.pdfMade by Claude
  • Every Monday at 9:00Claude scheduled task
  • Sent to team@yourcompany.comFrom your own address, with HeyMetra email

Without HeyMetra

ChatGPT
How many of this month’s sign-ups have already paid in Stripe?
I don’t have access to PostHog and Stripe. If you export this month’s sign-ups and Stripe’s customers and share it, I can compare.

With HeyMetra

ChatGPT
How many of this month’s sign-ups have already paid in Stripe?
Read with HeyMetra
212 signed up, 47 paid; people who finished onboarding paid 3× as often.
Make this a PDF and email it to the team every Monday at 9:00.
  • report.pdfMade by ChatGPT
  • Every Monday at 9:00ChatGPT scheduled task
  • Sent to team@yourcompany.comFrom your own address, with HeyMetra email

Without HeyMetra

Grok
Where in the sign-up funnel did we lose the most people this week, compared with last week?
I’m not connected to PostHog. Upload both weeks of the funnel as CSV and I’ll try.

With HeyMetra

Grok
Where in the sign-up funnel did we lose the most people this week, compared with last week?
Read with HeyMetra
The plan step lost 12 points more than last week; the drop is on mobile only.
Email this to the team.
  • Sent to team@yourcompany.comFrom your own address, with HeyMetra email

Without HeyMetra

Perplexity
Did people who used the new feature this month renew their subscription more often?
I can’t reach your PostHog and RevenueCat data. Share feature usage and renewals and I’ll look into it.

With HeyMetra

Perplexity
Did people who used the new feature this month renew their subscription more often?
Read with HeyMetra
Users of the feature renewed at 81%, others at 69%.
Email this to the team.
  • Sent to team@yourcompany.comFrom your own address, with HeyMetra email

What it can change, once you say yes

  • Add a note to your charts, such as the day a release went out

  • Turn a feature flag on or off

  • Save a new insight to a dashboard

  • Post the answer in a Slack channel you choose

Your assistant tells you in one line what it will change, and nothing reaches the account until you say yes in the chat. HeyMetra cannot undo a change afterwards. What to ask any connector that can make changes

What PostHog is

What it reads

PostHog is product analytics: every event your app or site sends, the funnels and retention built on top of them, the cohorts of people behind a number, session replays and feature flags. It is where "what did people actually do" is answered, as opposed to what an ad platform says it delivered.

Events

Which events fired, how often and when, so a question like how many people signed up last week has a direct answer.

Funnels and retention

Where people drop out of a flow and how many come back, including the insights your team already saved in PostHog.

Your own queries

Questions PostHog's saved views do not cover, answered straight from the project with a read-only key.

What it costs to read PostHog

Pricing

A PostHog key counts as one connection on your plan, and the questions you ask through it are not metered. Every plan includes it.

  • Starter

    For one person starting with their main account.

    $6$5/mo

    billed monthly $60 billed annually, save 17%

    Try free for 7 daysTry free for 7 days
    • 2 connectors at once
    • 2 accounts across them
    • 1 seat
    • Unlimited conversations
  • Superior

    For teams and agencies with many accounts to connect.

    $49$40.83/mo

    billed monthly $490 billed annually, save 17%

    Try free for 7 daysTry free for 7 days
    • 50 connectors at once
    • Unlimited number of accounts
    • 3 seats
    • Unlimited conversations
  • Enterprise

    For organizations with custom scale and security needs.

    • Custom connectors
    • Custom accounts
    • Custom seats
    • Unlimited conversations

    Contact us

    Contact sales

Frequently asked

Does it work if we host PostHog ourselves?

Yes, as long as your installation answers on a public address. The connection calls it from our servers, so an address that only works inside your network or behind a VPN cannot be reached, and there is no agent to install that gets around that.

Which scopes should the key have?

For reading: projects, insights, queries and events, each as read. Leave the write scopes off unless you want your assistant to be able to propose changes. If a scope is missing, PostHog answers 403 and names the one it wanted.

Only some of our products show up. Why?

A personal key reaches the projects its owner can open. A project someone else owns and never shared with you is invisible to the key, not empty. Ask to be added to it, then reconnect.

Can I ask about months of raw events at once?

You can ask, and PostHog may refuse a very large query on time. The data is queried, not exported, so a narrower period or a saved insight answers faster.

Works well with PostHog

Works well with

PostHog tells you what people did inside your product. Google Search Console tells you which searches brought them there in the first place, and the two together connect a query to a signup.

Add HeyMetra to your AI assistant

Connectors

Add your own connectorAdd custom connector

Add custom connector https://mcp.heymetra.com/mcp Add

Settings → Customize → Connectors

Step-by-step setup in Claude →
Setting it up 6 steps. You copy a key or the connection details from the account and paste them into HeyMetra.

Six steps, most of them in your own PostHog settings. Two are worth knowing first: the key is a personal one and is shown only once, and if you run PostHog on your own server, its address has to be reachable from the internet.

  1. 1

    Say whether PostHog is theirs or yours

    PostHog Cloud is the hosted one you sign in to at posthog.com. Choose your own server only if somebody at your company installed PostHog on a machine you run.

    You are not asked which Cloud region you are in. A personal API key belongs to one region and is refused by the other, so HeyMetra asks the key rather than asking you.

  2. 2

    If it is your own server, note its address

    The address you open PostHog at, like analytics.acme.com. On PostHog Cloud there is nothing to fill in here, and the box is not shown.

  3. 3

    Open Settings → Personal API keys

    It is under your own account menu rather than the project's settings. A personal API key belongs to you, not to one project, and reaches every project you can open.

    PostHog allows ten personal keys per person. Make one for HeyMetra rather than reusing the key in a script: revoking it later then costs nothing else.

  4. 4

    Create a key with read scopes

    Choose the scopes rather than granting everything. Reading needs Projects, Insights, Queries and Events, which PostHog lists as `project:read`, `insight:read`, `query:read` and `event:read`. Leave the write scopes off unless you intend to let your assistant propose changes.

    If a scope turns out to be missing, PostHog answers 403 and names the one it wanted, so this is correctable rather than a guess you are stuck with.

  5. 5

    Copy the key immediately

    It starts with `phx_` and is shown once. Refreshing the page loses it, and there is no way to read it back; the only remedy is creating another one.

  6. 6

    Paste it into HeyMetra and name the connection

    On the Connections screen choose PostHog, paste the key, type the address from step one, and name the connection after the product rather than after PostHog. The key is stored encrypted and never shown again, and HeyMetra checks it works against that address before keeping it.

Then add HeyMetra where you ask

When it does not work 4 common problems and how to fix each one.

Four things go wrong here. A key PostHog rejects is usually the right key at the wrong address. After that it is either a missing scope, which PostHog names for you, or a project nobody shared with you.

The key is rejected and it was copied correctly.
The address is the wrong one. A key issued in the EU account is not a key the US host has ever seen, and a key from a company's own installation is unknown to both. All three look like a bad key rather than a wrong address.
Sign in to PostHog, read the address out of the address bar, and edit the connection to match.
You run PostHog yourselves and it is not reachable from the internet.
HeyMetra calls your installation from its own servers. An address that only resolves inside your network, or one behind a VPN, is not an address we can reach.
Connect an installation that answers on a public address. There is no tunnel or agent to install, and nothing here can work around it.
It connects, but a question comes back with 403.
The key was made without the scope that question needs. Reading events and running a HogQL query are separate scopes, so one can work while the other does not.
Add the scope in PostHog (the 403 names it), or create a key with the read scopes and replace this one with the pencil. The connection keeps its name and everything pointing at it.
Only some of your products appear.
A personal API key reaches the projects YOU can open. A project somebody else owns and never shared is not one of them.
Ask to be added to that project in PostHog, then reconnect so the project list is read again.

Ask where people leave your onboarding

Add your projects to HeyMetra once, then ask about signups and funnels in plain words.

Or read the same steps on GitHub: zeisoft/posthog-mcp.