PyCronofy

What it is and what it does

pycronofy is a Python wrapper around the Cronofy calendar API, a service that aggregates access to multiple calendar providers (Google Calendar, Outlook, etc.) through a unified interface. It handles OAuth token management, request signing, and pagination transparently, so you can read events, create or update events, manage notification channels, and check free/busy blocks without building HTTP calls directly.

The library is designed for applications that need to integrate calendar functionality without managing separate OAuth flows for each calendar provider. It supports both OAuth tokens (obtained through user authorization) and personal access tokens for testing, and includes built-in validation and error handling for common API mistakes.

Use it for:

• Fetch upcoming events from a user's calendar(s) within a date range for display in a scheduling application.
• Create or update calendar events programmatically with automatic timezone handling and unique event ID management.
• Set up push notification channels to be alerted when a user's calendars change, enabling real-time sync.
• Query free/busy information across multiple calendars to find available time slots for meeting scheduling.
• Revoke or refresh OAuth tokens as part of user account management or security workflows.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for the Cronofy calendar API, enabling OAuth-based access to read, create, and manage calendar events across multiple calendar providers.

Yes. The package is actively maintained, has no known vulnerabilities, carries a permissive MIT license, and depends only on the widely-used requests library. Install it if you need to integrate Cronofy calendar access into a Python application—it handles the OAuth and API plumbing so you don't have to.

Install

pycronofy on PyPI

pip install pycronofy

uv add pycronofy

poetry add pycronofy

Installing PyCronofy

Before you install

Low install friction with a single runtime dependency (requests). Actively maintained as of June 2026, marked Production/Stable. Supports current Python versions (3.7+).

License in practice

MIT license (permissive) — you can use, modify, and distribute this library freely in both open and closed projects with minimal restrictions.

Quickstart

pip install pycronofy

import pycronofy
import datetime

cronofy = pycronofy.Client(access_token='YOUR_TOKEN')
events = cronofy.read_events(
    calendar_ids=('cal_id',),
    from_date=datetime.datetime.utcnow() - datetime.timedelta(days=2),
    to_date=datetime.datetime.utcnow()
)
for event in events:
    print(event['summary'])

Requires a valid Cronofy API token (OAuth or personal access token) and network access to Cronofy's API endpoints.

Verify before relying

• Whether the library supports all current Cronofy API endpoints or only a subset of the full API surface.
• Performance characteristics when handling large event result sets or many concurrent calendar reads.

Package facts

Evidence: pycronofy-2.1.0-py2.py3-none-any.whl

Tags

More Python Modules packages