Skip to main content
The Google Calendar connector mounts primary-calendar events as local files and uses reviewed draft files to create new events.

​
Connect

​
Mount

Optional explicit date window:

​
Projection

  • events/ contains read-only primary-calendar event files;
  • draft/ accepts new Markdown files that create events after review and push;
  • the full Google Calendar event resource is stored under google_calendar.event;
  • the Markdown body is the event description.
By default, pull uses a rolling window from 30 days back through 180 days forward. Recurring events are expanded in the projection.

​
Creating events

Create a Markdown file directly under draft/:
Review and push the draft:
Pushing sends attendee updates. When google_calendar.conference is google_meet, Locality requests a Google Meet link during event creation.

​
Current limits

  • Only the primary calendar is projected.
  • Existing event files under events/ are read-only.
  • Remote Google Calendar drafts are not projected.
  • Attachments are rendered as metadata but are not uploaded from Locality drafts in V1.
  • Incremental sync tokens are not persisted; pull uses bounded date-window enumeration.