Getting Started

First-Time Setup

After installing rscalendar and placing your OAuth2 credentials, authenticate:

rscalendar auth

This opens your browser for Google OAuth2 consent. The token is cached at ~/.config/rscalendar/token_cache.json for future use.

If you’re on a headless machine:

rscalendar auth --no-browser

This prints the auth URL instead of opening a browser.

List upcoming events:

rscalendar list

List more events:

rscalendar list --max-results 25

Create an all-day event:

rscalendar create --summary "Team offsite" --start 2026-04-01 --end 2026-04-02

Create a timed event:

rscalendar create --summary "Standup" --start "2026-04-01T09:00:00+03:00" --end "2026-04-01T09:15:00+03:00"

Delete an event by ID (shown in list output):

rscalendar delete --event-id <EVENT_ID>