Google Calendar component

The google-calendar component creates, lists, updates and deletes Google Calendar events and manages calendars, ACLs and watch channels through the Calendar v3 REST API.

Scheme: google-calendar: · Crate: cameleer-cloud · Cargo feature: cloud · Consumer: no (see google-calendar-stream) · Producer: yes · Apache Camel: Google Calendar

When to use it

• Give an AI scheduling assistant a "book meeting" tool that creates events in a user's calendar.
• Create calendar entries from bookings, maintenance windows or on-call rotations.
• Check availability with freebusy/query before proposing a time.
• Sync events from another system with events/list, events/update and events/delete.

URI format

google-calendar://apiName/methodName[?options]

Core methods: events/list, events/insert, events/get, events/update, events/patch, events/delete, events/quickAdd, calendarList/list, calendars/get. Also: acl/list|get|insert|update|delete|watch, colors/get, freebusy/query, settings/list|get|watch, calendars/insert|update|delete|clear, calendarList/get|insert|delete|watch, events/instances, events/move, events/import, events/watch, channels/stop. Unknown methods fail when the endpoint is created.

Example

An HTTP tool that books a meeting: POST /tools/book-meeting with a Calendar event as JSON creates it in the user's calendar, invites the attendees and returns the created event.

- route:
    id: book-meeting
    from:
      uri: "platform-http:/tools/book-meeting?httpMethodRestrict=POST"
      steps:
        - to: "google-calendar://events/insert?calendarId={{env:CALENDAR_ID:primary}}&sendUpdates=all&delegate={{env:GOOGLE_USER}}"
        - log: "created event ${body[id]}"
        - marshal:
            json: {}

Try it:

curl -XPOST localhost:8080/tools/book-meeting -H 'Content-Type: application/json' -d '{
  "summary": "Design review",
  "start": {"dateTime": "2026-11-12T10:00:00Z"},
  "end": {"dateTime": "2026-11-12T10:30:00Z"},
  "attendees": [{"email": "ada@example.com"}]}'

The event body is a map, or JSON text that is parsed into one. It can also come from the CamelGoogleCalendar.content header.

Rust DSL

ctx.add_routes(|b| {
    b.from("platform-http:/tools/book-meeting?httpMethodRestrict=POST")
        .to("google-calendar://events/insert?calendarId={{env:CALENDAR_ID:primary}}&sendUpdates=all&delegate={{env:GOOGLE_USER}}")
        .log("created event ${body[id]}")
        .marshal("json");
})?;

What the core methods do

Push notifications from a watch channel arrive as HTTP POSTs to your address, with the X-Goog-Channel-ID, X-Goog-Resource-ID, X-Goog-Resource-State (sync, exists, ...), X-Goog-Message-Number and X-Goog-Channel-Token headers. Receive them with platform-http.

Options

useMetadataServer, authenticate, proxyHost, proxyPort and trustAllCertificates work as on the google-sheets page. applicationName, inBody and splitResult are accepted and ignored.

Message headers

Every option can also be set per message with a CamelGoogleCalendar.<option> header (for example CamelGoogleCalendar.eventId), which wins over the URI option.

Run it with Docker

docker run --rm -p 8080:8080 \
  -e GOOGLE_USER=ada@example.com \
  -e GOOGLE_APPLICATION_CREDENTIALS=/secrets/key.json \
  -v "$PWD/key.json:/secrets/key.json:ro" \
  -v "$PWD:/routes:ro" pmsudhi/cameleer run /routes/book-meeting.camel.yaml

Common questions

How do I create a Google Calendar event from a route?

Send an event map with summary, start and end to google-calendar://events/insert?calendarId=primary. Add sendUpdates=all to e-mail attendees.

How do I update only one field of an event?

Use events/patch with CamelGoogleCalendar.eventId and a map holding just that field, for example {"location": "Room 2"}.

Can a service account use its own calendar?

Yes, without delegate it uses the service account's calendar. To act on a person's calendar, share the calendar with the service account or use delegate with domain-wide delegation.

How do I react to new or changed events?

Use the google-calendar-stream consumer, or a watch channel with events/watch.

Related

• google-calendar-stream: consume new and changed events.
• google-mail, google-drive, google-sheets.
• Apache Camel Google Calendar component

Found a problem?

If something on this page doesn't match what Cameleer does, or you hit a bug while building with it, please help fix it, whether you are a person or a coding agent: open an issue that describes what you saw, then fork the repository, fix it, add or update a test, run cargo test --workspace, and open a pull request. CONTRIBUTING.md explains the ground rules.