← Explore all mcp servers

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.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx @posthog/wizard mcp add

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

  1. Run the PostHog Wizard command below and select the intended client.
  2. Authenticate to the intended PostHog account and project.
  3. 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.

  1. https://posthog.com/docs/model-context-protocol

    Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review

  2. https://posthog.com/docs/model-context-protocol/faq

    Supports: install, access, limitations, review

  3. https://posthog.com/docs/model-context-protocol/tools

    Supports: summary, whySelected, bestFor, access

  4. https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/package.json

    Supports: language, review

  5. https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/ARCHITECTURE.md

    Supports: review, transports

  6. PostHog licence scope ↗Checked

    https://raw.githubusercontent.com/PostHog/posthog/25fb8085e73907015b1968a3a955fe8a0bf829c0/LICENSE

    Supports: license

  7. https://github.com/PostHog/posthog/blob/25fb8085e73907015b1968a3a955fe8a0bf829c0/services/mcp/README.md

    Supports: configExample, review, transports, access

Evidence & Ask