---
title: "PostHog MCP: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/posthog/
description: "Query product data, investigate errors, and manage feature flags or experiments in a PostHog project."
---

# PostHog MCP: review, setup & limitations · Undominated.ai

> Query product data, investigate errors, and manage feature flags or experiments in a PostHog project.

[← Explore all mcp servers](/mcp-servers/)

PRODUCT ANALYTICS / PostHog

# PostHog MCP

Query product data, investigate errors, and manage feature flags or experiments in a PostHog project.

 [See setup guidance ↓](#setup)[Original source ↗](https://posthog.com/docs/model-context-protocol)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 7 linked sources
 Publisher PostHog
 Licence [MIT (MCP service source; enterprise code excluded) ↗](https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/LICENSE)
 Revision 25fb8085e739
 [Read what was—and wasn’t—checked ↓](#review)

“Once connected, your agent can read and write across PostHog's products.”

 [PostHog · upstream description ↗](https://posthog.com/docs/model-context-protocol) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Links analytics and error investigation with feature-flag and experiment workflows.
- Documented project scoping, read-only mode and tool filters support narrower client access.

### A good fit for

 - Investigate a product error alongside usage data.
- Review and adjust an explicitly approved feature flag or experiment.

### Weigh up before choosing

 - Write tools can change project behaviour, including flags and experiments.
- Some tools use models internally and may incur PostHog AI spend; when the organization's AI data processing is off, those tools are filtered out.
- Combining features and tools filters forms a union, so it can expose more tools than either filter alone.
- The FAQ warns that prompt injection can make an agent follow untrusted commands, and says to review MCP tool calls before running them.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - PostHog MCP overview, FAQ/advanced setup and tool reference pages, read 2026-10-13.
- services/mcp README.md, package.json and ARCHITECTURE.md, and the root LICENSE, at 25fb8085e73907015b1968a3a955fe8a0bf829c0.

### Our findings

 - OAuth routes the account to its US or EU region. For clients without OAuth, the FAQ documents a personal API key with the MCP Server preset, which it says scopes access to a specific project.
- The readonly query parameter or x-posthog-read-only header excludes write tools; pinning a project (x-posthog-project-id or project_id) removes the switch-organization and switch-project tools.
- The services/mcp README says cli mode, a single exec tool that lists, searches and calls the other tools, is the default for all clients; only Cursor is auto-selected into tools mode. mode=tools or the x-posthog-mcp-mode header overrides it.
- GitHub reports NOASSERTION for the repository because the root LICENSE carves out the ee/ directory; services/mcp is outside ee/, and its package.json (@posthog/mcp) declares MIT.
- configExample is the services/mcp README's manual-install block at 25fb8085: npx mcp-remote@latest against https://mcp.posthog.com/mcp with an Authorization header; the key value is the README's own placeholder.
- Re-pinned from dac21711924ee4e8762c201906252eae0c8dbd4c to 25fb8085e73907015b1968a3a955fe8a0bf829c0; the root LICENSE is byte-identical between them.

### Not established by this review

 - Server launch, authenticated tool calls, and release-to-source parity were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://posthog.com/docs/model-context-protocol)

DOCUMENTED COMMAND

 npx @posthog/wizard mcp add Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - Run the PostHog Wizard command below and select the intended client.
- Authenticate to the intended PostHog account and project.
- For an investigation-only session, use the documented readonly=true endpoint option; review flag or experiment writes separately.

### Before you start

 - PostHog account/project access.
- Node.js/npx for the wizard, or manual remote-client setup.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "posthog": {
 "command": "npx",
 "args": [
 "-y",
 "mcp-remote@latest",
 "https://mcp.posthog.com/mcp",
 "--header",
 "Authorization:${POSTHOG_AUTH_HEADER}"
 ],
 "env": {
 "POSTHOG_AUTH_HEADER": "Bearer {INSERT_YOUR_PERSONAL_API_KEY_HERE}"
 }
 }
 }
} Copy configuration ↗

### Compatibility

Claude Code · Claude Desktop · Codex · Cursor · VS Code · Windsurf · Zed

### Implementation

TypeScript

### Transports

Streamable HTTP

### Remote OAuth or project API key

 - Reads authorized product analytics, errors, SQL results and project objects.
- Can create, update or delete supported resources unless the connection is restricted to read-only tools.
- Authenticates by OAuth or by a personal API key sent as an Authorization: Bearer header; one connection acts as one account with one active organization and project.

### Cost model

MCP access has no separate charge in the current guide; underlying service usage and AI-powered tools can incur account charges.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [PostHog MCP setup and scope ↗](https://posthog.com/docs/model-context-protocol) Checked 2026-10-13 https://posthog.com/docs/model-context-protocol Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review
- [PostHog authorization, filtering and billing boundaries ↗](https://posthog.com/docs/model-context-protocol/faq) Checked 2026-10-13 https://posthog.com/docs/model-context-protocol/faq Supports: install, access, limitations, review
- [PostHog MCP tool inventory ↗](https://posthog.com/docs/model-context-protocol/tools) Checked 2026-10-13 https://posthog.com/docs/model-context-protocol/tools Supports: summary, whySelected, bestFor, access
- [PostHog MCP package manifest ↗](https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/package.json) Checked 2026-10-13 https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/package.json Supports: language, review
- [PostHog MCP architecture ↗](https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/ARCHITECTURE.md) Checked 2026-10-13 https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/ARCHITECTURE.md Supports: review, transports
- [PostHog licence scope ↗](https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/LICENSE) Checked 2026-10-13 https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/LICENSE Supports: license
- [PostHog MCP README (services/mcp) ↗](https://github.com/PostHog/posthog/blob/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/README.md) Checked 2026-10-13 https://github.com/PostHog/posthog/blob/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/README.md Supports: configExample, review, transports, access

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Amplitude MCP Server ↗ Amplitude's hosted MCP server for analysing product data, experiments and user behaviour: search dashboards, charts, notebooks and experiments, query charts and metrics, analyse experiment significance, and search session replays — with separate US and EU endpoints for data residency.](/mcp-servers/amplitude/)[### Microsoft Clarity MCP Server ↗ Query Clarity dashboard metrics and filtered session-recording references through a local adapter to Microsoft-hosted endpoints.](/mcp-servers/microsoft-clarity/)[### Mixpanel MCP ↗ Investigate events and funnels and manage Mixpanel reports, Lexicon and experiments with existing project permissions.](/mcp-servers/mixpanel/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
