/google-calendar-simple-api

Pythonic wrapper for the Google Calendar API

Primary LanguagePythonMIT LicenseMIT

Google Calendar Simple API

PyPi Package Documentation Status Tests Discord

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

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