Google Calendar
The Google Calendar connector indexes your events into the local SQLite index and exposes read tools for calendars and events. Read-only: there are no write tools.
What’s indexed
Section titled “What’s indexed”- Service id:
google_calendar - Item type:
event - Window: one day back to 30 days ahead, kept current every five minutes; the window is re-anchored every seven days, so the far edge is at least 23 days ahead between re-anchors.
- Calendars: every calendar you have selected in Google Calendar that you can read in full, at most 20 (your primary calendar first). A calendar you unselect loses its events from the index.
- Per event: title, a short description preview, location, start and end times (all-day events run from midnight to midnight in this machine’s time zone), whether you accepted, the organizer’s address and the number of attendees. Attendee addresses are not stored. Recurring events appear as their individual instances.
Authenticate
Section titled “Authenticate”nimbus connector auth google_calendarThis is its own consent: it asks only for https://www.googleapis.com/auth/calendar.readonly. Connecting Gmail, Drive or Photos does not give Nimbus access to your calendar, and Google Calendar sync stays off until you run this command. You use your own Google OAuth client (NIMBUS_OAUTH_GOOGLE_CLIENT_ID, a Desktop app client; nimbus connector auth google_calendar --help prints the setup), and its consent screen must list calendar.readonly with the Google Calendar API enabled. calendar.readonly is a Google sensitive-scope permission, but you do not need Google’s verification for your own client: leave it in Testing with your account as a test user (Google then expires its refresh tokens after 7 days, so you re-run this command weekly), or publish it to In production without submitting it and accept Google’s “unverified app” warning once (an unverified client is limited to 100 users). Google requires verification for a client offered to the public, whatever its user count, but not for one only you use.
Read tools (no HITL)
Section titled “Read tools (no HITL)”| Tool | Purpose |
|---|---|
gcal_calendar_list |
List the calendars you can see. |
gcal_event_get |
Get a single event by id. |
gcal_event_list |
List events in a time window. |