Skip to main content
Mixpanel Headless is an open-source SDK that exposes the full Mixpanel platform — every query engine, report type, and configuration — as a single Python object. Build agents, notebooks, scheduled scripts, or ETL pipelines that work with your product data the same way a human analyst would, without a browser.

​
When to use Mixpanel Headless

Headless is for coding agents and developers — anything that writes or generates Python to call Mixpanel.
  • Mixpanel Agent is the conversational AI inside the Mixpanel UI.
  • MCP Server connects chatbots (Claude, ChatGPT, and others) to your data for natural-language Q&A.
  • Mixpanel Headless is the SDK for coding agents (Claude Code, Codex, Cursor) and for scripts, notebooks, and pipelines you write yourself.

​
Get started

pip install mixpanel-headless
Then follow the quickstart on GitHub.

​
Rate limits

The default API limit is 60 requests per hour. For production workloads or higher volume, request early access.

​
Resources