Best PostHog MCP server: 6 options compared
Quick answer: PostHog's own remote server at mcp.posthog.com is the broadest option for product teams. Ryze AI is the best PostHog MCP server for marketers who already run ads through Ryze AI, with one caveat: it has 3 PostHog tools and one project per connection.
Below: 6 servers checked on November 10, 2026, PostHog's official options, API limits and test prompts.
Ryze AI · Paid Ads
PostHog in the Ryze AI connector
- 7-day free trial, $89 a month flat
Used by 2,000+ marketers
The best PostHog MCP servers at a glance
Ranked for marketers and analysts who want an AI assistant to read PostHog and change a few objects. Ryze AI publishes this page, so rank 1 is on that axis only.
- 1Ryze AI MCPHosted
Who it is for: Marketers who also run ads in Ryze AI
PostHog access: 3 tools: read (with HogQL), write, delete
Price: From $89 a month, 7-day free trial
- 2PostHog official MCPHosted by PostHog
Who it is for: Product and engineering teams
PostHog access: Broad: analytics, flags, experiments, errors
Price: Free to connect
- 3Composio PostHog toolkitHosted
Who it is for: Developers building agents
PostHog access: 686 tools, 11 triggers
Price: Free tier, then usage
- 4PostHog/mcp (archived)Local or hosted
Who it is for: Reference only
PostHog access: Moved into the PostHog monorepo
Price: Free
- 5mcp-research/PostHog__posthog-mcpLocal
Who it is for: Claude Desktop users who want annotations
PostHog access: Projects and annotations
Price: Free
- 6Zapier MCPHosted
Who it is for: Teams already on Zapier
PostHog access: 1 trigger and 1 action
Price: Zapier plan
| # | MCP server | Runs | Who it is for | PostHog access | Price |
|---|---|---|---|---|---|
| 1 | Ryze AI MCP | Hosted | Marketers who also run ads in Ryze AI | 3 tools: read (with HogQL), write, delete | From $89 a month, 7-day free trial |
| 2 | PostHog official MCP | Hosted by PostHog | Product and engineering teams | Broad: analytics, flags, experiments, errors | Free to connect |
| 3 | Composio PostHog toolkit | Hosted | Developers building agents | 686 tools, 11 triggers | Free tier, then usage |
| 4 | PostHog/mcp (archived) | Local or hosted | Reference only | Moved into the PostHog monorepo | Free |
| 5 | mcp-research/PostHog__posthog-mcp | Local | Claude Desktop users who want annotations | Projects and annotations | Free |
| 6 | Zapier MCP | Hosted | Teams already on Zapier | 1 trigger and 1 action | Zapier plan |
Rows 1 to 3 can change PostHog data through MCP when the key allows it. Row 4 is an archived repo, row 5 is a small community server and row 6 can only send events and watch for actions.
How these PostHog MCP servers were compared
Each server was checked against its own docs, GitHub page or toolkit page on November 10, 2026. No customer PostHog data was used.
- Who it is for: a marketer, a product team or a developer building an agent.
- PostHog access: which objects it reads and what it can create, change or delete.
- Auth and guardrails: OAuth or a personal API key, and what stands between the agent and live data.
- Upkeep and price: who hosts it, whether the repo is active and what it costs.
PostHog's own server ranks second only because the axis here is a marketer who wants analytics next to ad accounts. For the Ryze AI setup, read the PostHog MCP page.
The 6 PostHog MCP servers, one by one
1. Ryze AI MCP
A hosted MCP server you add to Claude or ChatGPT as one connector URL, https://connector.get-ryze.ai/mcp. PostHog connects with a personal API key and your host (US Cloud, EU Cloud or a self-hosted URL), then you pick a project. The same connector also serves the other platforms connected in your Ryze AI workspace. Disclosure: Ryze AI publishes this page.
PostHog tools
3: read (projects, insights, dashboards, feature flags, cohorts, persons, event definitions and HogQL queries), write (insights, dashboards, feature flags, cohorts) and delete.
Guardrail
A key with read scopes only keeps the agent read-only. In Claude, write and delete tools can be set to Needs approval.
Limit
One PostHog project per connection. HogQL queries need a time window and a row limit of 1,000 at most.
Price
A Ryze AI plan or trial; Paid Ads is $89 a month with a 7-day free trial. Connecting is free.
Setup steps and the tool list are on the PostHog MCP page. Other platforms are on the developers page.
2. PostHog official MCP server
PostHog's hosted server at https://mcp.posthog.com/mcp. It supports OAuth and personal API keys, and the login routes you to your US or EU region. PostHog lists Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed, Codex, Lovable, Replit and v0 as supported clients.
Made by
PostHog. Its docs describe tools for analytics queries, feature flags, experiments, error triage, HogQL and more.
Setup
Run npx @posthog/wizard mcp add, or follow the per-client guide in the docs.
Guardrail
The docs page I opened does not describe a read-only mode; a key with narrow scopes limits what it can do. Self-hosting is not covered there.
Price
Connecting and calling tools is free, but some tools use LLMs internally and may be billed as PostHog AI spend. AI tools need AI data processing enabled in organization settings.
3. Composio PostHog toolkit
A developer platform that exposes many apps through one MCP gateway or SDK. Its PostHog toolkit lists 686 tools and 11 triggers and signs in with a PostHog API key. Agents connect through hosted MCP servers or its API.
Writes
Yes. The page lists flags, experiments, dashboards, cohorts, batch exports, error tracking and surveys.
Guardrail
No approval gate is described on the toolkit page; use your client's tool permissions.
Setup
A Composio account plus your own PostHog credentials.
Price
The page lists a free tier of 100,000 tool calls a month with no credit card; paid plans bill usage.
4. PostHog/mcp on GitHub (archived)
The original official repo has 151 stars and an MIT license. PostHog archived it on January 19, 2026 and moved the code into its monorepo under services/mcp. Use the monorepo or the hosted server for anything new.
Status
Read-only archive; no new commits.
Setup
The README points to npx @posthog/wizard@latest mcp add.
Price
Free, open source.
5. mcp-research/PostHog__posthog-mcp
A small community server with 0 stars, 11 commits and an MIT license. It lists the projects in your organization and adds annotations, and its README targets Claude Desktop. The page did not show a last commit date. Treat it as a minimal example.
Auth
A PostHog API key with annotation:write and project:read scopes.
Setup
Python 3.10 or later and the uv package manager.
Price
Free, open source.
6. Zapier MCP
Zapier MCP lists two PostHog capabilities: a trigger when an action is performed and a Capture Event action. It cannot read insights or run queries. It suits teams that already send events from Zapier.
Writes
Capture Event only, with organization, project, event name and distinct ID.
Reads
None beyond the action trigger.
Price
The page I opened did not list task usage per call; check Zapier's pricing.
PostHog's own MCP options and who each is for
PostHog documents one hosted server and keeps its code in the main repository.
Hosted server, mcp.posthog.com/mcp
- Where it runs
- PostHog
- Who it is for
- Anyone with a PostHog Cloud account
- Auth
- OAuth or personal API key
EU endpoint, mcp-eu.posthog.com
- Where it runs
- PostHog
- Who it is for
- EU Cloud accounts that use API keys
- Auth
- Personal API key as a Bearer token
services/mcp in the PostHog monorepo
- Where it runs
- Your machine or your own host
- Who it is for
- Developers who read or run the code
- Auth
- Personal API key as a Bearer token
| Option | Where it runs | Who it is for | Auth |
|---|---|---|---|
| Hosted server, mcp.posthog.com/mcp | PostHog | Anyone with a PostHog Cloud account | OAuth or personal API key |
| EU endpoint, mcp-eu.posthog.com | PostHog | EU Cloud accounts that use API keys | Personal API key as a Bearer token |
| services/mcp in the PostHog monorepo | Your machine or your own host | Developers who read or run the code | Personal API key as a Bearer token |
The monorepo README describes two modes: cli, the default, with a single exec tool, and tools, with one tool per operation. A request header, x-posthog-mcp-mode, sets the mode. The README also lists more than 50 feature categories.
If you only want PostHog in Claude, the official server is the direct route. Ryze AI adds value when the agent also works on your ad and SEO accounts in the same workspace.
PostHog API limits every MCP server runs into
Servers that use a personal API key call the same PostHog API, so the same limits apply (PostHog API docs):
Analytics (insights, persons, recordings)
- Limit
- 240 a minute, 1,200 an hour
- What it means for an agent
- Many dashboard reads in one chat can hit the hourly cap
Query endpoint
- Limit
- 2,400 an hour
- What it means for an agent
- HogQL-heavy chats use this budget
Events values
- Limit
- 60 a minute, 300 an hour
- What it means for an agent
- Property value lookups run out first
CRUD (create, read, update, delete)
- Limit
- 480 a minute, 4,800 an hour
- What it means for an agent
- Bulk edits to flags or cohorts go in batches
| Endpoint type | Limit | What it means for an agent |
|---|---|---|
| Analytics (insights, persons, recordings) | 240 a minute, 1,200 an hour | Many dashboard reads in one chat can hit the hourly cap |
| Query endpoint | 2,400 an hour | HogQL-heavy chats use this budget |
| Events values | 60 a minute, 300 an hour | Property value lookups run out first |
| CRUD (create, read, update, delete) | 480 a minute, 4,800 an hour | Bulk edits to flags or cohorts go in batches |
PostHog says most limits apply per personal API key, and that OAuth or logged-in sessions do not use up personal API key limits. Ryze AI uses a personal API key, so its calls count against that key. For large one-off exports, PostHog points to file download exports or batch exports.
In Ryze AI, PostHog stops unbounded HogQL queries, so ask for a time window and at most 1,000 rows.
How to choose a PostHog MCP server
Start from who will use the agent and whether it should change anything.
You run ads and want PostHog in the same chat
Ryze AI MCP
One connector for PostHog and the other platforms in your workspace. Ad-side picks: best MCP for Google Analytics covers GA4.
You are a product or engineering team
PostHog official MCP server
Hosted by PostHog, OAuth sign-in and the widest tool coverage in this list.
You build agents over many apps
Composio
A free tier and a very large tool list, with your own credentials.
You want free and self-run
PostHog monorepo services/mcp
Open source, kept current by PostHog.
You only send events from Zapier
Zapier MCP
Capture Event and one trigger, no reads.
You only want reports
Any server with a read-only key
Create a personal API key with read scopes only.
Using GA4 as well? See how to connect Claude to Google Analytics. Everything else on the hub: Integrations.
Prompts to test any PostHog MCP server
Run these with a read-only key first.
A list of projects comes back. A server without project access cannot answer.
This shows whether the server runs HogQL and respects a time window and row limit.
A table of dashboards and flags comes back if the key has read access to them.
You see the real permissions before you ask for edits.
With write and delete tools set to Needs approval in Claude, the call waits for your click.
Access and safety checklist before you connect
- Create a personal API key in PostHog under Settings, Personal API keys, with read access to the projects you need and the Query and Insight scopes.
- Add write scopes only for objects the agent should change. A read-only key makes PostHog reject changes.
- Use the right host: https://us.posthog.com, https://eu.posthog.com or your self-hosted URL.
- Require approval: in Claude, set write and delete tools to Needs approval under Customize, Connectors, Ryze AI, Tool permissions. The Ryze AI chat starts on Skip all approvals, and scheduled tasks run without an approval step.
- Treat deletes as irreversible. The Ryze AI delete tool removes an object by path, for example a cohort.
- Know how to revoke: delete the personal API key in PostHog, or disconnect PostHog in Ryze AI with the trash icon on its card.
More on connecting: the Ryze AI help center has the PostHog guide.
Sources
Checked November 10, 2026
The verdict
Pick by who uses the agent. Product teams start with PostHog's own server, developers building agents look at Composio, and marketers who already work in Ryze AI can add PostHog to the connector they use. Whichever you choose, start with a read-only key and add write scopes only when a task needs them.