PostHog MCP server: PostHog in Claude, ChatGPT and Cursor

“PostHog MCP” can mean four things in 2026. PostHog runs its own free, hosted MCP server at https://mcp.posthog.com/mcp that covers most PostHog products, installs it into editors with the PostHog Wizard, and ships a plugin for Claude Code and other clients. The Ryze AI server is a separate one: it reaches PostHog through your personal API key and shares a URL with the Ryze AI ad and analytics tools. This page documents the Ryze AI server and compares it with PostHog’s options in section 06.

The tool names come from the Ryze AI connector’s source. No workspace had PostHog connected on the day this page was checked, so the live tool list and the exact input fields were not inspected, and none are listed here. The agent reads the schemas when it calls a tool.

A HogQL question, as the agent might write it

SELECT properties.utm_campaign AS campaign, count() AS signups
FROM events
WHERE event = 'sign_up'
  AND timestamp >= now() - INTERVAL 30 DAY
GROUP BY campaign
ORDER BY signups DESC
LIMIT 100

Sign-up events from the last 30 days grouped by campaign, with a time window and a row limit because PostHog stops unbounded queries. The event name is an example; the agent can list your event definitions first to find the right one. Ad and analytics tools on the same URL are documented on Google Ads MCP, Meta Ads MCP and Google Analytics MCP.

The join between an ad platform and PostHog runs through the properties PostHog stores on each event. When ad URLs carry utm_source, utm_medium and utm_campaign and your PostHog setup captures them as event properties, a HogQL query can group conversions by campaign, and the ad tools return cost for the same campaign names. If a property is not captured, ask the agent to list your event definitions to see what is there.

Every answer comes from your own PostHog project and ad accounts, so no sample numbers are shown here. For the web analytics side of the same questions, see the best MCP servers for Google Analytics.

Step 1: link your PostHog project in Ryze AI

1. 01In PostHog, open Settings, Personal API keys and click Create key. Grant read access to the projects you want, including the Query and Insight scopes. Copy the key, which starts with phx_.
2. 02In the Ryze AI app, open Integrations, click Connect on the PostHog card and paste the key.
3. 03Enter the Host: https://us.posthog.com for US Cloud, https://eu.posthog.com for EU Cloud, or your self-hosted URL. Click Continue.
4. 04Pick the Project and click Save. The card shows Connected, and View lets you change the project later.

Prefer to stay in the chat? Ask the Ryze AI agent in Claude or ChatGPT to connect PostHog. It sends a one-time link, valid once and for 24 hours, to a page where you paste the key and enter the host. Screens for each step are in the Ryze AI help center.

Claude on the web or desktop

1. 01Go to Customize, Connectors.
2. 02Choose + Add, then Add custom connector. Enter Ryze AI as the name and https://connector.get-ryze.ai/mcp as the MCP server URL, then Continue. Keep OAuth sign-in; do not choose No sign in.
3. 03Press Add, then Connect on the Ryze AI connector, sign in, choose the workspace that holds PostHog and press Allow connection.
4. 04Claude keeps the tool list from the moment the connector is added. If you connected PostHog after that, remove the connector, add it again and start a new chat.

Custom connectors work on Free, Pro, Max, Ultra, Team and Enterprise, and Free allows one. On Team and Enterprise an Owner adds Ryze AI under Organization settings, Connectors, and each member then clicks Connect.

ChatGPT

Per OpenAI, custom MCP server connections are available on ChatGPT Business and Enterprise/Edu on the web, and Pro can connect with read and fetch permissions only. On Business, an admin or owner creates and publishes it. Open Plugins (chatgpt.com/plugins), select the plus button, then Add custom MCP server. Name it Ryze AI, enter the URL under Connection, choose OAuth, accept the risk warning, create the plugin and review the discovered tools. Sign in to Ryze AI, choose the workspace and click Allow connection.

The older route in Settings, Apps, Advanced settings, Developer mode, Create app also works for accounts that still show it, as the Ryze AI help center describes. After you connect PostHog later, remove the app, install it again and start a new chat. Plan rules differ between sources; the OpenAI article above is the one this page follows.

Claude Code

claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user

Run /mcp, select ryze and finish sign-in in the browser. --scope user loads it in every project. Claude Code needs a Pro, Max, Ultra, Team, Enterprise or Console account.

Cursor

{ "mcpServers": {
  "ryze": { "url": "https://connector.get-ryze.ai/mcp" }
} }

Save it as ~/.cursor/mcp.json for all projects or .cursor/mcp.json for one. Cursor runs OAuth with PKCE, so you sign in on the Ryze AI page and click Allow connection. Cursor asks for approval before using MCP tools by default. The developer page has an Add to Cursor link and configs for other editors.

Grok

On grok.com, go to Connectors, click New Connector, choose Custom, enter the URL and sign in to Ryze AI. In Grok Bot, the Ryze AI help center says Ryze AI is listed under Connect apps: search Ryze AI, Add and sign in. If it is not listed, add the URL as a custom MCP server. On Grok Business and Enterprise a team admin adds the connector in the console first.

From the Ryze AI help center, checked Nov 8, 2026. Read access is enough for reporting. To keep the agent read-only, give the key read scopes only, and PostHog rejects any change. What the agent can change is limited by the scopes on the key, so add write access only to the scopes it should edit.

Removing access

In Ryze AI, open View on the PostHog card and use the trash icon to disconnect. Then delete the personal API key under Settings, Personal API keys in PostHog so the key stops working everywhere. In Claude, open Customize, Connectors, Ryze AI and click Disconnect, which cuts off every workspace at once.

Four things called PostHog MCP

Sources: PostHog’s MCP overview, tools reference and FAQ, checked Nov 8, 2026. PostHog’s server is free to connect to; some of its tools use LLMs internally and may be billed as PostHog AI spend.

Ryze AI and PostHog’s server side by side

As published on Nov 8, 2026. PostHog adds tools to its server often, so check its tools reference before you decide.

Which to pick: if the work stays inside PostHog, PostHog’s own server covers far more of it (error tracking, experiments, surveys, session replay, the data warehouse) and signs in with OAuth, so it is the better fit for engineers and product teams. Ryze AI fits when the question crosses tools, such as sign-ups by Google Ads campaign or Meta Ads spend beside a funnel, or when the same login already runs your ad accounts. Nothing stops you from adding both to one client.

From PostHog’s API docs and MCP FAQ, checked Nov 8, 2026. Some endpoints set their own limits per project or per organization. Ryze AI does not publish which PostHog endpoints its tools call, so treat the numbers as the ceiling PostHog documents.

The first two rows are from the Ryze AI help center and the rest follow how the Ryze AI connector works. No third-party error reports are quoted here. More answers are in the integrations FAQ.