Oxagen Docs

Google Calendar

Ingest calendar events, attendees, and locations into the workspace knowledge graph. People you meet about become first-class entities your AI agents can query across surfaces.

Google Calendar logo

Google Calendar

Events + attendees → `meeting` and `person` nodes.

The Calendar connector scans events from the authenticated user's calendar into the workspace ontology. Each event is a meeting node; every attendee resolves to a person node deduplicated by email; the event description and location feed the LLM extractor so the topics and locations you meet about land as typed nodes.

Calendar history is a richer signal than most other surfaces — the default backfill window is 365 days, not 90.

What gets ingested

SourceNode typeEdge typeDirection
Calendar eventmeeting
Organizerpersonorganized / organized_byPerson ↔ Meeting
Attendee (accepted / tentative)personinvited_to / has_attendeeMeeting ↔ Person
Location (when set)locationat_locationMeeting → Location
Topic / concept extracted from descriptionconceptdiscussesMeeting → Concept

A person who attends both your Gmail threads and your calendar events resolves to one node — the lowercased email is the canonical dedup key across every Google connector.

Real use cases

  • Who am I meeting this week?MATCH (m:meeting)-[:has_attendee]->(p:person) WHERE m.start >= datetime() RETURN p, count(m) gives you a "people I'm seeing this week" list, sortable by meeting count.
  • External vs internal — combined with email-domain filtering, the same query splits "customers I'm seeing" from "internal syncs."
  • Cross-source intelligence — pair with the Zoom connector and the calendar event (the invite) wires to the same Zoom meeting node (the recording + transcript). Sales reps get one timeline per account: the invite, the actual call, the action items, the follow-up emails.

Settings

KeyTypeDefaultDescription
backfill_daysnumber365How far back to scan calendar history.
include_declinedbooleanfalseWhen true, events you declined are still ingested.
include_cancelledbooleanfalseWhen true, cancelled events still create a meeting node with a cancelled: true property.

OAuth scopes

  • calendar.readonly — read events and event metadata
  • calendar.events.readonly — read individual event details
  • userinfo.email — resolve the connecting user's email

Read-only only. The connector cannot create, modify, or delete events on your calendar.


Get started free · Connectors overview

On this page