English Français العربية

io.github.friendlygeorge/posthog-mcp-server

Official registry Archived Marketing and sales

MCP server for PostHog — product analytics for AI assistants. Query events, persons, insights, da...

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package posthog-mcp-server
Claude Code 
claude mcp add posthog-mcp-server -- npx -y posthog-mcp-server@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "posthog-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "posthog-mcp-server@1.0.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PostHog MCP Server
  2. Features
  3. Quick Start
  4. Environment Variables
  5. Example Queries
  6. API Reference
  7. Development
  8. License

PostHog MCP Server

Connect AI assistants to PostHog — query events, persons, insights, dashboards, feature flags, cohorts, and experiments through the Model Context Protocol.

Works with Claude Desktop, Cursor, Windsurf, Cline, Continue, and any MCP-compatible client.

Features

ToolDescription
list_eventsQuery events with filters (event name, person, date range, properties)
get_personGet a person (user) by distinct_id — properties, creation date, event count
list_personsSearch and list persons with pagination
list_dashboardsList all dashboards — names, tags, widget counts
get_dashboardGet a specific dashboard with its insights and widgets
execute_insightExecute a saved insight (trend, funnel, etc.) and get results
list_feature_flagsList all feature flags — key, active status, rollout percentage
evaluate_feature_flagEvaluate a flag for a specific user and get variant value
list_cohortsList cohorts — name, type (dynamic/static/SQL), person count
list_experimentsList A/B tests — name, status, feature flag, dates
get_experimentGet experiment results with variant data and statistical significance
list_actionsList custom event actions/definitions
get_project_infoGet project name, ID, settings, and data region

Quick Start

1. Get a PostHog API Key

Go to PostHog → Settings → Personal API Keys and create a key with read access.

Or visit: https://your-instance.posthog.com/settings/user-api-keys

2. Configure your MCP client

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "posthog": {
      "command": "npx",
      "args": ["-y", "posthog-mcp-server"],
      "env": {
        "POSTHOG_API_KEY": "phx_YOUR_API_KEY_HERE",
        "POSTHOG_HOST": "https://us.i.posthog.com",
        "POSTHOG_PROJECT": "YOUR_PROJECT_ID"
      }
    }
  }
}

Cursor — add to MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "posthog": {
      "command": "npx",
      "args": ["-y", "posthog-mcp-server"],
      "env": {
        "POSTHOG_API_KEY": "phx_YOUR_API_KEY_HERE",
        "POSTHOG_HOST": "https://us.i.posthog.com",
        "POSTHOG_PROJECT": "YOUR_PROJECT_ID"
      }
    }
  }
}
3. Run manually (for testing)
# Clone and build
git clone https://github.com/friendlygeorge/posthog-mcp-server.git
cd posthog-mcp-server
npm install
npm run build

# Run
POSTHOG_API_KEY=phx_... POSTHOG_PROJECT=12345 node dist/index.js

Environment Variables

VariableRequiredDefaultDescription
POSTHOG_API_KEY✅—Your PostHog personal API key (phx_...)
POSTHOG_HOST❌https://us.i.posthog.comPostHog instance URL (use https://eu.i.posthog.com for EU)
POSTHOG_PROJECT❌""Default project ID. If empty, must be specified per-call.
Self-hosted PostHog

If you run PostHog on your own infrastructure, set POSTHOG_HOST to your instance URL:

POSTHOG_HOST=https://posthog.yourcompany.com

Example Queries

Once configured, ask your AI assistant:

  • "Show me the last 20 pageview events"
  • "Who are the most active users this week?"
  • "What's the status of our signup conversion experiment?"
  • "Is the new-checkout-flow feature flag enabled for user abc123?"
  • "Show me all active dashboards"
  • "Execute insight 42 and show me the trend"
  • "List all feature flags that are currently active"
  • "How many people are in the 'Power Users' cohort?"

API Reference

This server wraps the PostHog REST API (v1). Full documentation:

Development

npm install
npm run dev     # Build and run
npm run build   # Build only
npm start       # Run built output

License

MIT © Nova

Frequently asked questions

What is io.github.friendlygeorge/posthog-mcp-server?

MCP server for PostHog — product analytics for AI assistants. Query events, persons, insights, da...

How do I install io.github.friendlygeorge/posthog-mcp-server?

It runs on your machine. In Claude Code: claude mcp add posthog-mcp-server -- npx -y posthog-mcp-server@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.friendlygeorge/posthog-mcp-server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.friendlygeorge/posthog-mcp-server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.friendlygeorge/posthog-mcp-server?

It is published by friendlygeorge. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.