PRODUCT ANALYTICS / PostHog
PostHog MCP
Query product data, investigate errors, and manage feature flags or experiments in a PostHog project.
“Once connected, your agent can read and write across PostHog's products.”
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.
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.
DOCUMENTED COMMAND
npx @posthog/wizard mcp add 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}"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://posthog.com/docs/model-context-protocol
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review
https://posthog.com/docs/model-context-protocol/faq
Supports: install, access, limitations, review
- PostHog MCP tool inventory ↗Checked
https://posthog.com/docs/model-context-protocol/tools
Supports: summary, whySelected, bestFor, access
https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/package.json
Supports: language, review
- PostHog MCP architecture ↗Checked
https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/ARCHITECTURE.md
Supports: review, transports
- PostHog licence scope ↗Checked
https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/LICENSE
Supports: license
https://github.com/PostHog/posthog/blob/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/README.md
Supports: configExample, review, transports, access