Skip to main content

Simple API for Google Calendar management

Project description

PyPi Package Documentation Status Tests

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


pip install gcsa

from sources:

git clone
cd google-calendar-simple-api
python install

See Getting started page for more details.

Example usage

List events

from gcsa.google_calendar import GoogleCalendar

calendar = GoogleCalendar('')
for event in calendar:

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'

Create recurring event

from gcsa.recurrence import Recurrence, DAILY

event = Event(
    start=date(2020, 7, 16),

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


Template for was taken from kennethreitz/

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gcsa-1.2.1.tar.gz (24.3 kB view hashes)

Uploaded Source

Built Distribution

gcsa-1.2.1-py2.py3-none-any.whl (27.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page