Developers
Use the Python client as a starting point for integrations, dashboards, or custom data pipelines.
Who it is for
Built for developers, hobby projects, and school automation.
School operators
Sync Compass events into internal systems, Google Calendar, or bespoke admin tools.
AI and MCP workflows
Feed structured Compass data into assistants and automations without scraping the UI every time.
How it works
A simple two-step flow.
Log in through Chrome via CDP
The project uses Zendriver for the one-shot login flow, avoiding the WebDriver fingerprints that usually trigger problems.
Switch to direct API requests
Session cookies are reused with a Chrome-like TLS fingerprint, so calendar and school data can be fetched without a browser.
Current scope
Practical pieces already in the repo.
Low-level Python client
The `compass_py` package handles login, session state, calendar events, user details, and news feed retrieval.
Higher-level services
The workspace also includes an HTTP service, admin frontend, and MCP server for broader integration use cases.
Interest
Want to follow the project?
Star the repository, open an issue with your use case, or reach out if you want to test early integrations around calendar sync and school data access.
Open an issue