Google Calendar Simple API

Google Calendar Simple API or gcsa is a library that simplifies event and calendar management in Google Calendars. It is a Pythonic object oriented adapter for the official API. See the full documentation.

Installation

Using uv:

uv add gcsa

Using pip:

pip install gcsa

See Getting started page for more details and installation options.

Example usage

List events

from gcsa.google_calendar import GoogleCalendar

calendar = GoogleCalendar('your_email@gmail.com')
for event in calendar:
    print(event)

Create event

from gcsa.event import Event

event = Event(
    'The Glass Menagerie',
    start=datetime(2020, 7, 10, 19, 0),
    location='Záhřebská 468/21',
    minutes_before_popup_reminder=15
)
calendar.add_event(event)

Create recurring event

from gcsa.recurrence import Recurrence, DAILY

event = Event(
    'Breakfast',
    start=date(2020, 7, 16),
    recurrence=Recurrence.rule(freq=DAILY)
)
calendar.add_event(event)

Suggestion: use beautiful_date to create date and datetime objects in your projects (because it's beautiful... just like you).

References

Template for setup.py was taken from kennethreitz/setup.py