---
id: pycronofy
version: "2.1.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# PyCronofy — Python library for Cronofy

License: permissive · Maintenance: active · Downloads: 191.6K/mo

## 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 above — 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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 191.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

calendar api client python, cronofy python sdk, oauth calendar integration, read write calendar events, multi-calendar management, calendar event sync, cronofy api wrapper, calendar-integration, oauth-client

[View on SkillFed](https://skillfed.io/packages/pycronofy) · [View on PyPI](https://pypi.org/project/pycronofy/)