Authentication
rscalendar uses OAuth2 to access the Google Calendar API on your behalf.
How It Works
- You provide OAuth2 client credentials (a JSON file from Google Cloud Console)
- On first use, rscalendar opens your browser to get consent
- The access token is cached locally for future requests
Files
| File | Location | Purpose |
|---|---|---|
| Credentials | ~/.config/rscalendar/credentials.json | OAuth2 client ID and secret |
| Token cache | ~/.config/rscalendar/token_cache.json | Cached access/refresh tokens |
Commands
Authenticate (opens browser):
rscalendar auth
Authenticate without browser (prints URL):
rscalendar auth --no-browser
Force re-authentication (removes cached token first):
rscalendar auth --force
Scopes
rscalendar requests the https://www.googleapis.com/auth/calendar scope, which provides full read/write access to your Google Calendar.