integrations tools posthog
PostHog MCP for your AI agent
Cogny's PostHog integration exposes 15 tools (15 read) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.
- 15readonly reads data.
- 0writecreates or changes something.
- 0destructivedeletes, removes or replaces something.
Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits
set it up.
Add Cogny to your AI client once, then connect PostHog in Cogny. Every PostHog tool below appears in the client.
- Claude CodeRun
claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser. - Claude.aiSettings → Connectors → Add custom connector, URL
https://app.cogny.com/mcp, then log in and pick your workspace. - ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL
https://app.cogny.com/mcp, authentication OAuth. - CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into
.mcp.json, with an API key. - CodexRun
codex mcp add cogny --url https://app.cogny.com/mcp.
what each tool does.
Read 15 · only reads data
get_current_userReadGet the current user profile.list_projectsReadList all PostHog projects (teams) the API key can access.list_insightsReadList saved insights (charts, funnels, retention etc.) in a project.get_insightReadGet a single saved insight including its result data.list_dashboardsReadList dashboards in a project.list_eventsReadList recent events for a project with optional filters.list_event_definitionsReadList event definitions (names) captured in the project.list_property_definitionsReadList property definitions (event or person properties) for a project.list_personsReadList persons (user profiles) in a project.get_personReadGet a single person's profile and all their properties.list_cohortsReadList cohort definitions in a project.list_session_recordingsReadList session recording metadata for a project.list_feature_flagsReadList feature flag definitions in a project.get_event_trendReadCount an event per day, week or month over a date range — the number behind a PostHog trend chart, without saving an insight.run_hogqlReadRun one HogQL SELECT against the project's events, persons and sessions and get the rows back — for any aggregate get_event_trend cannot express.
Exact input schemas come from tools/list once PostHog is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.