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

# Calendar Integration

> Connect your calendar so Victoria AI knows your schedule and availability

## Calendar Integration Overview

Victoria AI's Calendar Integration connects your Google Calendar or Microsoft Outlook to give Victoria awareness of your schedule, court dates, and availability—enabling smarter scheduling and context-aware assistance.

## Why Connect Your Calendar?

**Victoria AI becomes more helpful when she knows your schedule:**

<CardGroup cols={2}>
  <Card title="Avoid Conflicts" icon="calendar-xmark">
    Victoria checks for conflicts before suggesting meeting times or deadlines
  </Card>

  <Card title="Context-Aware Responses" icon="brain">
    Victoria references upcoming court dates and deadlines in her responses
  </Card>

  <Card title="Smart Scheduling" icon="calendar-check">
    Get suggestions that work with your existing commitments
  </Card>

  <Card title="Deadline Tracking" icon="bell">
    Automatic awareness of court dates and filing deadlines
  </Card>
</CardGroup>

## Supported Platforms

### Google Calendar

Connect any Google Calendar account:

* Personal Gmail calendars
* Google Workspace (business) calendars
* Multiple calendars per account
* All calendar permissions (read-only)

### Microsoft Outlook Calendar

Connect Microsoft calendars:

* Outlook.com personal calendars
* Microsoft 365 business calendars
* Exchange Online calendars
* All calendar permissions (read-only)

<Note>
  Victoria only reads your calendar events—she never creates, modifies, or deletes events.
</Note>

## How to Connect Your Calendar

<Steps>
  <Step title="Go to Calendar Settings">
    Navigate to **Settings** → **Calendar Integration** in your dashboard
  </Step>

  <Step title="Choose Calendar Provider">
    Click either:

    * **Connect Google Calendar**
    * **Connect Microsoft Outlook**
  </Step>

  <Step title="Authorize Access">
    You'll be redirected to Google or Microsoft to:

    * Sign in (if not already signed in)
    * Review requested permissions
    * Click "Allow" to grant Victoria read-only access

    **Permissions requested:**

    * Read calendar events
    * Read calendar metadata (calendar names, colors)
    * No write permissions (Victoria cannot modify your calendar)
  </Step>

  <Step title="Select Calendars">
    Choose which calendars to sync:

    * Work calendar
    * Personal calendar (optional)
    * Specific case calendars

    You can sync multiple calendars or just one.
  </Step>

  <Step title="Sync Complete">
    Victoria immediately syncs your calendar events and will:

    * Update every 60 seconds for new events
    * Reference events when providing assistance
    * Check for conflicts when scheduling
  </Step>
</Steps>

## What Gets Synced

Victoria syncs the following information from your calendar:

**Event Details:**

* Event title
* Start date and time
* End date and time
* Location (if specified)
* All-day event flag
* Recurrence pattern (for recurring events)

**Not Synced:**

* Event descriptions
* Attendee lists
* Attachments
* Private notes

<Tip>
  Calendar events marked as "Private" in Google/Outlook are treated as busy time without revealing details.
</Tip>

## How Victoria Uses Your Calendar

### Conflict Detection

When you ask Victoria to schedule something:

```
You: "Can we schedule the Smith deposition for next Tuesday at 2pm?"

Victoria: "I see you have a conflict on Tuesday, November 12 at 2:00 PM:
- Event: 'Jones Mediation'
- Time: 2:00 PM - 4:00 PM
- Location: Superior Court

Would you like to schedule the Smith deposition for:
- Tuesday 10:00 AM (available)
- Wednesday 2:00 PM (available)
- Thursday 9:00 AM (available)"
```

### Deadline Awareness

Victoria references your court dates:

```
You: "What's my timeline for the Johnson case?"

Victoria: "Based on your calendar:
- Trial date: December 15, 2024 (Court Room 3, 9:00 AM)
- Days until trial: 28 days

Key deadlines:
- Witness list due: November 30 (13 days)
- Trial briefs due: December 8 (21 days)
- Jury instructions due: December 10 (23 days)"
```

### Availability Suggestions

Victoria suggests times that work:

```
You: "When can I meet with the client this week?"

Victoria: "Based on your calendar availability:

Monday:
- 9:00 AM - 11:00 AM (available)
- 2:00 PM - 4:00 PM (available)

Wednesday:
- 10:00 AM - 12:00 PM (available)
- 3:00 PM - 5:00 PM (available)

Your busiest day is Thursday (6 events scheduled)."
```

## Managing Your Calendar Connection

### View Connection Status

At **Settings** → **Calendar Integration**:

**Connected Calendars:**

* Google Calendar: [john@smithlawfirm.com](mailto:john@smithlawfirm.com)
  * Work Calendar (synced)
  * Personal Calendar (synced)
  * Last sync: 2 minutes ago
  * Status: ✅ Connected

**Sync Status:**

* Events synced: 247
* Next sync: 58 seconds
* Last successful sync: 2 minutes ago

### Disconnect Calendar

To stop syncing:

1. Go to **Settings** → **Calendar Integration**
2. Click **Disconnect** next to the connected calendar
3. Confirm disconnection

**What happens:**

* Victoria stops syncing new events
* Previously synced events are deleted from Victoria's database
* You can reconnect anytime

### Reconnect Calendar

If sync stops working:

1. Disconnect the calendar
2. Reconnect with fresh authorization
3. All events re-sync automatically

## Privacy & Security

### Data Protection

Your calendar data is protected by:

**Encryption:**

* OAuth tokens encrypted at rest (AES-256)
* All sync traffic encrypted (TLS 1.3)
* Calendar events stored encrypted

**Access Control:**

* Only you can see your calendar events
* Victoria AI can reference events for your requests only
* Other firm members cannot see your calendar

**Token Security:**

* Refresh tokens rotated regularly
* Tokens expire after 90 days of inactivity
* Automatic revocation on disconnect

### OAuth Security

We use OAuth 2.0 with PKCE (Proof Key for Code Exchange):

* Industry standard for secure authorization
* No password sharing required
* Revokable access anytime
* Same security as "Sign in with Google"

### What Victoria Knows vs. Doesn't Know

**Victoria Knows:**

* You have an event at 2:00 PM Tuesday
* The event title is "Deposition"
* The location is "Conference Room A"
* You're busy from 2:00-4:00 PM

**Victoria Doesn't Know:**

* Who else is attending
* Email addresses of attendees
* Event description details
* Private notes or attachments

## Troubleshooting

<AccordionGroup>
  <Accordion title="Calendar won't connect" icon="link-slash">
    **Solutions:**

    1. Ensure you're signed in to Google/Microsoft
    2. Allow pop-ups for divorce.law domain
    3. Clear browser cache and try again
    4. Try a different browser
    5. Check if third-party cookies are enabled
  </Accordion>

  <Accordion title="Events not syncing" icon="sync">
    **Solutions:**

    1. Check connection status (Settings → Calendar)
    2. Verify you have internet connection
    3. Ensure calendar permissions weren't revoked
    4. Disconnect and reconnect calendar
    5. Check if calendar has events (empty calendars show 0 synced)
  </Accordion>

  <Accordion title="Victoria shows wrong availability" icon="calendar-exclamation">
    **Solutions:**

    1. Check which calendars are synced
    2. Verify event times are correct in Google/Outlook
    3. Wait 60 seconds for latest sync
    4. Check if event is marked as "free time" instead of "busy"
  </Accordion>

  <Accordion title="Want to sync only work calendar" icon="briefcase">
    **Solution:**
    When connecting, uncheck personal calendars in the calendar selection step. You can change this later in Settings.
  </Accordion>
</AccordionGroup>

## Advanced Features

### Multiple Calendar Support

Sync multiple calendars from different accounts:

* Work Google Calendar ([john@firm.com](mailto:john@firm.com))
* Personal Google Calendar ([john@gmail.com](mailto:john@gmail.com))
* Microsoft Outlook ([john@outlook.com](mailto:john@outlook.com))

Victoria combines all calendars to show complete availability.

### Recurring Events

Victoria understands recurring events:

* Weekly meetings (every Monday at 9 AM)
* Monthly court appearances
* Annual deadlines

Recurring events are treated as busy time for all occurrences.

### All-Day Events

All-day events are handled specially:

* Marked as busy but can be overridden
* Victoria asks before scheduling over all-day events
* Good for vacation days, holidays, conferences

### Time Zone Support

Calendar events sync with original time zones:

* Automatic conversion to your local time
* Handles DST (Daylight Saving Time) transitions
* Correct times even when traveling

## Best Practices

<Tip>
  **Keep court dates on calendar:** Add all court dates, deadlines, and hearings to your calendar so Victoria can remind you and avoid conflicts.
</Tip>

<Tip>
  **Use descriptive event titles:** Instead of "Meeting", use "Smith Case - Client Meeting" so Victoria can reference specific events.
</Tip>

<Tip>
  **Block focus time:** Create calendar blocks for deep work (drafting motions, case research) so Victoria won't suggest scheduling during those times.
</Tip>

<Warning>
  **Don't put confidential details in event titles:** Victoria can see event titles. Use general titles like "Client Meeting" rather than specific case details.
</Warning>

## Revoking Access

### From Victoria AI

Disconnect at any time:

1. **Settings** → **Calendar Integration**
2. Click **Disconnect**
3. Your calendar data is immediately deleted

### From Google/Microsoft

Revoke Victoria's access directly:

**Google:**

1. Go to [https://myaccount.google.com/permissions](https://myaccount.google.com/permissions)
2. Find "Victoria AI"
3. Click **Remove Access**

**Microsoft:**

1. Go to [https://account.microsoft.com/privacy/app-permissions](https://account.microsoft.com/privacy/app-permissions)
2. Find "Victoria AI"
3. Click **Remove Permissions**

## Future Enhancements

Coming soon:

* **Write access**: Create calendar events from Victoria (optional)
* **Smart reminders**: Victoria sends reminders for upcoming court dates
* **Calendar sharing**: Share availability with clients
* **Automatic time blocking**: Victoria blocks time for case tasks
* **Integration with case deadlines**: Automatic calendar events for filing deadlines

## Next Steps

<CardGroup cols={2}>
  <Card title="Connect Your Calendar" icon="calendar-plus" href="/quickstart">
    Set up calendar integration in 2 minutes
  </Card>

  <Card title="Firm Settings Guide" icon="gear" href="/guides/firm-admin">
    Learn about other firm configuration options
  </Card>
</CardGroup>