> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langmail.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Use a calendar client

> Connect your Langmail calendar to Apple Calendar, Thunderbird, or Android — CalDAV settings and an app password for two-way sync.

Your Langmail calendars are standard CalDAV collections on `mail.langmail.me`. Any client that speaks CalDAV can subscribe to them for two-way sync, so events stay consistent across every client — including the invitations your agent sends.

## Before you start

Interactive sign-in for Langmail is Google-based, so calendar clients authenticate with an **app password** instead of your account password — the same credential mail clients use.

Open [webmail](https://webmail.langmail.me), go to **Settings → Security**, and generate an app password. The secret is shown once, so copy it right away. One app password works for both mail and calendar; you can create one per device and revoke each independently from the same page.

<Note>
  Most clients discover your calendars automatically from the server address using RFC 6764 (`/.well-known/caldav`). If yours asks for a specific calendar URL instead, your default calendar is `https://mail.langmail.me/dav/cal/you/default/` — replace `you` with the local part of your address. (The parent `/dav/cal/you/` holds all your calendars; each additional one has its own `/dav/cal/you/<id>/` URL.)
</Note>

## Connect your client

Use your full `you@langmail.me` address as the username and the app password as the password everywhere below.

<Tabs>
  <Tab title="Apple Calendar (Mac)">
    1. Open **System Settings → Internet Accounts → Add Account → Add Other Account**.
    2. Choose **CalDAV account**.
    3. Set **Account Type** to **Manual** and fill in:

    | Field          | Value              |
    | -------------- | ------------------ |
    | User Name      | `you@langmail.me`  |
    | Password       | your app password  |
    | Server Address | `mail.langmail.me` |

    4. Select **Sign In**. Your Langmail calendars appear in Calendar.
  </Tab>

  <Tab title="Apple Calendar (iPhone/iPad)">
    1. Open **Settings → Calendar → Accounts → Add Account → Other**.
    2. Tap **Add CalDAV Account** and fill in:

    | Field     | Value              |
    | --------- | ------------------ |
    | Server    | `mail.langmail.me` |
    | User Name | `you@langmail.me`  |
    | Password  | your app password  |

    3. Tap **Next**. Your calendars sync into the Calendar app.
  </Tab>

  <Tab title="Thunderbird">
    1. Open **File → New → Calendar → On the Network**.
    2. Enter your username `you@langmail.me` and the location `https://mail.langmail.me`, then let Thunderbird find your calendars.
    3. When prompted, enter the app password.
    4. Select the calendars you want and **Subscribe**.
  </Tab>

  <Tab title="Android (DAVx⁵)">
    Android has no built-in CalDAV support, so use [DAVx⁵](https://www.davx5.com), the standard open-source sync app (F-Droid or Play Store).

    1. In DAVx⁵, add an account with **Login with URL and user name**.
    2. Fill in:

    | Field     | Value                      |
    | --------- | -------------------------- |
    | Base URL  | `https://mail.langmail.me` |
    | User name | `you@langmail.me`          |
    | Password  | your app password          |

    3. Finish setup, then pick which calendars to sync. They appear in your Android Calendar app.
  </Tab>
</Tabs>

## Connection details

For any other CalDAV client, these are the settings:

| Setting        | Value                                                                                                            |
| -------------- | ---------------------------------------------------------------------------------------------------------------- |
| Server address | `mail.langmail.me` (discovery at `https://mail.langmail.me/.well-known/caldav`)                                  |
| Username       | your full `you@langmail.me` address                                                                              |
| Password       | an app password from [webmail](https://webmail.langmail.me) (**Settings → Security**)                            |
| Calendar URL   | `https://mail.langmail.me/dav/cal/you/default/` (your default calendar) — only if the client can't auto-discover |

An OAuth bearer token works too, over the same endpoint — that's what the MCP calendar tools use — but app passwords are the practical choice for desktop and mobile calendar apps.

## Google Calendar and Outlook

Neither Google Calendar nor classic Outlook can subscribe to a third-party CalDAV server for two-way sync — they only sync calendars within their own accounts. You can still invite people on those systems to your events: invitations go out as standard iMIP emails they can accept from Google Calendar, Outlook, or anything else that speaks iCalendar (see [Calendar workflows](/guides/calendar-workflows)). For two-way access from an Android phone, use DAVx⁵ as shown above.

## Next steps

<CardGroup cols={2}>
  <Card title="Calendar workflows" icon="calendar" href="/guides/calendar-workflows">
    Schedule meetings, recurring series, and RSVPs through an agent.
  </Card>

  <Card title="Use a mail client" icon="envelope" href="/guides/mail-clients">
    Read the same mailbox from Apple Mail, Thunderbird, or Outlook.
  </Card>

  <Card title="Open protocols" icon="plug" href="/reference/protocols">
    The full endpoint map for JMAP, CalDAV, IMAP, and SMTP.
  </Card>
</CardGroup>
