PostHog MCP Server

Official
by PostHog
MIT License
10
  • Apple

Integrations

  • Allows to list PostHog projects and create annotations in PostHog projects with optional timestamps directly through Claude Desktop

PostHog MCP Server 📊

A Model Context Protocol (MCP) server for interacting with PostHog. Create annotations and manage projects directly through Claude Desktop!

Features 🚀

  • List Projects: View all available PostHog projects in your organization
  • Create Annotations: Add annotations to your PostHog projects with optional timestamps [this list can be much longer, anything our api has basically...]

Setup 🛠️

  1. Prerequisites
    • Python 3.10 or higher
    • uv package manager
    • PostHog API Key with annotation:write and project:read scopes obtained from your project settings
  2. Installation
    # clone the repo git clone git@github.com:PostHog/posthog-mcp.git # or if https, use: git clone https://github.com/PostHog/posthog-mcp.git cd posthog-mcp uv venv source .venv/bin/activate # Install dependencies uv pip install .
  3. Configuration
    • Create a .env file in the project root:
      PERSONAL_API_KEY=phx_your_posthog_api_key_here
  4. Claude Desktop Setup
    • Install Claude Desktop
    • Open Claude Desktop settings and click "Edit Config". Alternatively, you can open the file from:
      • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
      • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Add this to your claude_desktop_config.json (adjust paths according to your system):
      { "mcpServers": { "posthog": { "command": "/path/to/uv", # Get this by running: which uv "args": [ "--directory", "/path/to/your/posthog-mcp", # Full path to this project "run", "posthog_mcp" ] } } }
      Check the latest documentation on setting up Claude Desktop as MCP client if you ran into any issues.

Usage 💡

After setup, you'll see a hammer 🔨 icon in Claude Desktop. The following commands are available:

List Projects

Ask Claude:

"List my PostHog projects"

Get and Search for Insights

Ask Claude:

"List my PostHog insights" or "Search for revenue insights in my PostHog"

Search for documentations online

You can ask:

  • "how can i do reverse proxy in nextjs in posthog?"

Create Annotation

Using the Project ID you get from the list of projects, ask Claude:

"Create a PostHog annotation in project 53497 saying 'Deployed v1.2.3'"

or with a specific date:

"Create a PostHog annotation in project 53497 for March 20th saying 'Started new marketing campaign'"

Troubleshooting 🔍

  • If the hammer icon doesn't appear, restart Claude Desktop
  • Check logs at ~/Library/Logs/Claude/mcp*.log (macOS) or %APPDATA%\Claude\logs (Windows)
  • Verify your PostHog API key has the correct permissions
  • Make sure all paths in claude_desktop_config.json are absolute paths

Contributing 🤝

Feel free to open issues and PRs! We follow PostHog's contribution guidelines.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that enables Claude Desktop users to interact directly with PostHog, allowing them to view projects and create annotations through natural language commands.

  1. Features 🚀
    1. Setup 🛠️
      1. Usage 💡
        1. List Projects
        2. Get and Search for Insights
        3. Search for documentations online
        4. Create Annotation
      2. Troubleshooting 🔍
        1. Contributing 🤝

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.
            Last updated -
            TypeScript
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that allows Claude to interact with Warpcast accounts, enabling actions like posting casts, reading content, searching by keywords, and managing channel interactions through natural language.
            Last updated -
            1
            JavaScript
          • A
            security
            A
            license
            A
            quality
            A collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.
            Last updated -
            2
            14
            TypeScript
            MIT License
            • Apple
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that allows Claude Desktop to manage and execute tasks in a queue-based system, supporting planning, execution, and completion phases.
            Last updated -
            322
            2
            TypeScript
            MIT License
            • Apple

          View all related MCP servers

          ID: zkqzx42bi8