# Runbook: show a Bundle calendar in Google Calendar, Apple Calendar and phones

> For AI agents helping a Bundle member. Human version: https://bundle.direct/blog/bring-your-calendar
> Last checked against Bundle on 2026-10-25.

## Goal

Make a person's Bundle events visible (read-only or two-way) in the calendar apps they already use.

## Important limitation

Bundle **cannot import** events from Google Calendar, Outlook or `.ics` files. Don't try to migrate past events into Bundle; plan an overlap instead (new meetings in Bundle, old recurring ones stay where they are until they end).

## How you act

- Settings live in the Bundle web app (https://app.bundle.direct) → **Calendar** → link icon in the header → **Sync with your phone**, in the person's own session.
- The subscription URL and the CalDAV app password are secrets: anyone with the link sees the events. Never ask for or paste them into chat; let the human copy them into the target app, or use a password manager.
- Calendar is in beta and enabled per workspace. Guests (restricted members) and agents have no calendar.

## Options

| | Subscription link | CalDAV | Phone sync (Bundle app) |
| --- | --- | --- | --- |
| Direction | read-only | two-way | two-way |
| Clients | Google Calendar, Apple Calendar, Outlook, any `.ics` subscriber | Apple Calendar (iPhone, Mac), DAVx5 (Android), Thunderbird | iOS and Android system calendars |

## Steps

### Subscription link (read-only)

1. Calendar → **Sync with your phone** → **Subscription link** → **Copy link** (format `https://app.bundle.direct/v1/cal/<token>.ics`).
2. **Human step:** Google Calendar → Other calendars → + → **From URL** → paste. iPhone: Settings → Calendar → Accounts → Add Account → Other → Add Subscribed Calendar. Mac: **Open in calendar app** (webcal link).
3. Google refreshes subscriptions every few hours.

### CalDAV (two-way)

1. Calendar → **Sync with your phone** → **Calendar account (CalDAV)** → **Create app password** (shown once). This password is shared with mail apps: creating it replaces the existing one for both; confirm with the user first.
2. **Human step:** iPhone/Mac: Settings → Calendar → Accounts → Add Account → Other → Add CalDAV Account. Server `app.bundle.direct`; user name = Bundle sign-in email; password = the app password. Android: DAVx5 with the same values (discovery: `/.well-known/caldav` → `/dav/`).
3. Rules: only the organizer can edit an event; deleting an invitation declines it.

### Phone sync in the Bundle app

- Android: Bundle app → Settings → Calendar → **Sync with phone calendar** (creates "Bundle — <workspace>"; syncs on open, on changes, hourly).
- iPhone: Bundle app → Settings → Calendar → **Sync with iPhone Calendar**; **human step:** allow full calendar access.

## Verify

1. Create a test event in Bundle; it appears in the target app (subscription: may take hours in Google).
2. CalDAV/phone sync: edit an event you organize in the phone calendar; the change shows in Bundle.

## Rollback

- Subscription: **Reset link** (old link stops immediately); remove the subscribed calendar from the app.
- CalDAV: **Turn off** (deletes the shared app password; mail apps stop too); remove the account on the device.
- Phone sync: switch the toggle off or sign out; the calendar is removed from the phone.
