BuilderIO/agent-native / packages/scheduling/docs/skills/integrations
integrations
UnverifiedCalendar + video provider integrations — Google Calendar, Office 365, Zoom, built-in video, Google Meet — and how to write new ones.
Integrations
Calendar providers
- google_calendar — OAuth; read freeBusy + write events; optionally
create Google Meet conference via
includeConference=true. - office365_calendar — Microsoft Graph; read freeBusy + write events.
- caldav (planned) — generic CalDAV for Apple iCloud, Fastmail, etc.
Video providers
- builtin_video — Daily.co-backed; zero OAuth; server-to-server API key.
- zoom_video — OAuth; create meetings via Zoom REST API.
- google_meet — piggy-backs on Google Calendar credential.
- teams_video — delegated Microsoft OAuth for work or school accounts; creates and cancels standalone meetings through Microsoft Graph.
Credential lifecycle
- User clicks "Connect" →
connect-calendarreturnsauthUrl+state - Redirect to provider → consent → provider redirects to our callback
- Server exchanges code → writes
scheduling_credentialsrow + coreoauth_tokensentry - We fetch calendar list, let user pick "checked" + "destination"
- Token expires → refresh flow runs silently; on failure, set
invalid: trueand show re-connect banner
Busy-time aggregation
aggregateBusy({userEmail, rangeStart, rangeEnd}) merges:
- Confirmed bookings hosted by the user
- External busy from each
selected_calendarsentry via the provider
If any selected calendar can't be read (its getBusy throws, its provider
isn't registered, or its credential is invalid), aggregateBusy,
getAvailableSlots, and assertSlotAvailable throw
CalendarAvailabilityUnavailableError (errorCode: "calendar_availability_unavailable", status 503, or 429 with Retry-After
when every failure was a provider throttle) naming the calendar,
instead of treating it as free. Show "Couldn't check " and offer no
times; tell the host to reconnect when the reason is credential_invalid.
Credentials with no selected calendars are not checked.
Cached in calendar_cache (short TTL, default 5 min). Busted on any
booking write for that host.
Writing a new provider
See docs/providers.md for the full interface.
Common tasks
| User | Action |
|---|---|
| "Connect Google Calendar" | connect-calendar --kind google_calendar --redirectUri ... → redirect to returned authUrl |
| "Stop checking my vacation calendar" | toggle-selected-calendar --include false for that externalId |
| "Default to Zoom for new bookings" | set-default-conferencing-app --credentialId <zoom-cred> |
| "Connect Microsoft Teams" | connect-video --kind teams_video --redirectUri ... → complete the callback with completeVideoOAuth() |
| "Default to Teams for new bookings" | set-default-conferencing-app --credentialId <teams-cred> |
| "Refresh calendar cache" | refresh-busy-times |
Microsoft Teams setup
Register createTeamsProvider() as a video provider with the deployment's
Microsoft client id and secret plus consumer-owned getAccessToken,
updateTokens, and markInvalid callbacks. The provider defaults to the
organizations tenant because Graph's delegated online-meeting API supports
work or school accounts, not personal Microsoft accounts. It requests only
offline_access, OnlineMeetings.ReadWrite, and User.Read.
Use connect-video to start OAuth and completeVideoOAuth() in the callback;
inserting a teams_video row with install-conferencing-app alone does not
grant Microsoft access. Token refresh remains the consumer's responsibility in
getAccessToken. The booking service stores the returned meeting id and join
URL in booking_references and calls the provider again on cancellation.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |