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

# Calendar Integration

> Let your front office agent show booking slots, create events, and send confirmations

When a prospect is ready to talk, your agent should move from conversation to a confirmed meeting without sending them away to a separate scheduling page.

BoostGPT supports a built-in calendar flow for front office agents:

```text theme={null}
Lead asks to book -> agent checks availability -> booking card appears
  -> visitor chooses a slot -> event is created -> confirmation email is sent
```

## How the built-in booking flow works

The calendar flow is powered by three built-in tools:

| Tool                          | What it does                                                                                             |
| ----------------------------- | -------------------------------------------------------------------------------------------------------- |
| `calendar_check_availability` | Searches for open slots in a date range, timezone, and meeting duration                                  |
| `calendar_request_booking`    | Shows an interactive booking card and waits for the visitor to pick a slot                               |
| `calendar_create_event`       | Creates the event and sends a confirmation email with an `.ics` file when an attendee email is available |

<Info>
  `calendar_request_booking` waits for visitor input. It is not an approval prompt. After the visitor chooses a slot, the agent should call `calendar_create_event` to finish the booking.
</Info>

## Setup

<Steps>
  <Step title="Enable Calendar">
    Open your agent, go to **Settings → Features & Options**, and enable **Calendar**.
  </Step>

  <Step title="Set booking defaults">
    Configure the timezone, default meeting duration, availability windows, and confirmation email behavior.
  </Step>

  <Step title="Update the agent instruction">
    Tell the agent when to offer booking, what meeting title to use, and what attendee details it needs before creating an event.
  </Step>

  <Step title="Test the booking flow">
    Ask the hosted agent or widget: "Can I book a 15-minute intro call this week?" Confirm that the booking card appears and the confirmation email arrives.
  </Step>
</Steps>

## Recommended agent instruction

```text theme={null}
When a visitor asks to book a call, collect their name, email,
timezone, and preferred duration if missing.

Use calendar_check_availability to find real open slots. If slots are
returned, show them with calendar_request_booking. Do not say there are
no available slots when availability returned slots.

After the visitor chooses a slot, use calendar_create_event to create
the event. calendar_create_event sends the attendee confirmation email,
so do not use notify_user as a calendar invite unless the visitor asks
for a separate follow-up notification.

In the final response, confirm the meeting time from display_time when
the tool returns it.
```

## What the visitor sees

The booking card appears directly inside chat. It can show slots grouped by date, with the attendee details already attached when the agent has them.

After the visitor selects a slot, BoostGPT creates the calendar event and emails the attendee with:

* meeting title
* confirmed time
* attendee details
* `.ics` calendar file
* Google Calendar and Outlook links when available

## External calendar connectors

You can still connect external calendar services when your agent needs to work with another scheduling system.

| Tool                | Best for                                            | Cost                                        |
| ------------------- | --------------------------------------------------- | ------------------------------------------- |
| **Calendly**        | Existing Calendly event types and team scheduling   | Free tier; paid plans for advanced features |
| **Cal.com**         | Open-source or self-hosted scheduling               | Free tier; paid plans for teams             |
| **Google Calendar** | Reading or writing directly to an existing calendar | Free with Google account                    |

<Steps>
  <Step title="Deploy the connector">
    Go to **Dashboard → Integrations → Connectors**, choose the calendar provider, and deploy it.
  </Step>

  <Step title="Authenticate">
    Complete the API key or OAuth flow for the provider.
  </Step>

  <Step title="Add to your agent">
    Open the agent's **Tools** tab and add the deployed connector.
  </Step>
</Steps>

## Use Cases

* Book discovery calls for qualified prospects
* Schedule coaching, consulting, onboarding, or support sessions
* Reschedule or cancel existing events
* Capture lead details before a meeting is booked
* Trigger CRM and workflow follow-up after booking

## Next Steps

<CardGroup cols={2}>
  <Card title="Deploy" icon="rocket" href="/creators/deploy">
    Launch the hosted page, widget, email channel, or workspace page
  </Card>

  <Card title="CRM" icon="address-book" href="/creators/integrations/crm">
    Capture contacts, deals, and pipeline stages
  </Card>
</CardGroup>