# Runbook: connect Bundle mail and calendar to an iPhone or Android phone

> For AI agents helping a Bundle member. Human version: https://bundle.direct/blog/connect-iphone-android
> Last checked against Bundle on 2026-10-28.

## Goal

Get a person's Bundle mail and calendar into the phone's own apps (iPhone Mail and Calendar; Gmail, Thunderbird or K-9 Mail and DAVx⁵ on Android). If they just want Bundle on the phone, point them to the Bundle app instead: it has mail, calendar and contacts with no setup.

## Important limitation

Bundle has **no CardDAV** server. Contacts cannot be synced into the iPhone or Android address book. Don't try to add a CardDAV account.

## How you act

- The app password is created in the Bundle web app (https://app.bundle.direct) → **Settings → Mail → Mail apps** → **Create app password**, or **Calendar → Sync with your phone → Create app password**. Same password either way; creating one revokes the previous one for every mail and calendar app. Confirm with the user before creating a new one.
- The app password is a secret. Never ask for it in chat or print it. The human copies it into the phone, or a password manager fills it.
- Mail and Calendar are beta features enabled per workspace.

## Settings

| What | Value |
| --- | --- |
| IMAP | `imap.bundle.direct`, 993, SSL/TLS |
| SMTP | `smtp.bundle.direct`, 465 SSL/TLS or 587 STARTTLS |
| Mail user name | the mailbox address (or an alias) |
| CalDAV | server `app.bundle.direct` (`/.well-known/caldav` → `/dav/`); base URL `https://app.bundle.direct/dav/` |
| CalDAV user name | the person's Bundle sign-in email (can differ from the mailbox address) |
| Password | the app password |

## Steps

### iPhone (iOS 27 menu names)

- Shortcut: right after creating the password in Settings → Mail → Mail apps, **Download iPhone and Mac profile** (`Bundle-<workspace>.mobileconfig`, contains the password) sets up every mailbox plus CalDAV. **Human step:** Settings → Profile Downloaded → Install.
- Mail: Settings → Apps → Mail → Mail Accounts → Add Account → Add Other Account → Mail Account → IMAP, then the values above.
- Calendar: Settings → Apps → Calendar → Calendar Accounts → Add Account → Add Other Account → CalDAV Account.

### Android

- Gmail app: profile picture → Add another account → Other → address → Personal (IMAP) → app password → servers above.
- Thunderbird for Android / K-9 Mail: add account, manual setup if servers aren't filled in, "Normal password".
- Calendar: DAVx⁵ (free on F-Droid, paid on Google Play) → + → Login with URL and user name → base URL above, Bundle sign-in email, app password → account name = email → allow calendar access → tick the Bundle calendar in the CalDAV tab.

## Troubleshooting

- Wrong password: create a new app password and enter it in every app; check the user name (mailbox address for mail, sign-in email for CalDAV).
- Repeated failures are delayed and then blocked for a while; wait before retrying.
- Nothing syncs: iPhone account toggles (Mail / Calendars) under Settings → Apps → Mail → Mail Accounts and Settings → Apps → Calendar → Calendar Accounts; on Android, the calendar ticked in DAVx⁵ and shown in the calendar app.
- Sending is only allowed from the signed-in mailbox or its aliases; only the organizer can edit an event.

## Verify

1. Send a test message from the phone; it appears in Sent in Bundle.
2. Create an event in Bundle; it appears in the phone's calendar. Edit an event you organize on the phone; the change shows in Bundle.
