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

# Calendar Integration

> Sync schedule entries and export events to external calendars

## Overview

Integrate Peanuts with your calendar to sync events, export schedules, and keep everything in one place.

## Calendar Export via Ask Peanuts

Generate calendar files (ICS) from any Helper data using Ask Peanuts.

### How to Export

<Steps>
  <Step title="Open Ask Peanuts">
    Tap the Ask Peanuts button from any Helper or the home screen.
  </Step>

  <Step title="Request calendar export">
    Ask something like: "Create a calendar file for my upcoming appointments"
  </Step>

  <Step title="Download ICS file">
    Peanuts generates an ICS file you can import into any calendar app.
  </Step>
</Steps>

### Example Prompts

* "Export my schedule for next week as a calendar file"
* "Create ICS events for all my upcoming deadlines"
* "Generate calendar entries for my medication schedule"
* "Make a calendar file from my workout plan"

<Info>
  Calendar export via Ask Peanuts costs **1 credit** per request.
</Info>

## Calendar Sync (Schedule Helper)

Sync Schedule Helper entries bidirectionally with external calendars.

<Info>
  Two-way calendar sync is available on **Pro** and **Team** plans.
</Info>

### Setup

<Steps>
  <Step title="Open Schedule Helper">
    Navigate to a Schedule-type Helper.
  </Step>

  <Step title="Access Calendar Settings">
    Go to **Settings → Calendar Sync** within the Helper.
  </Step>

  <Step title="Choose Provider">
    Select your calendar provider.
  </Step>

  <Step title="Authorize">
    Grant Peanuts access to your calendar.
  </Step>

  <Step title="Configure Sync">
    Choose sync direction and options.
  </Step>
</Steps>

### Sync Directions

| Direction              | Behavior                                          |
| ---------------------- | ------------------------------------------------- |
| **Peanuts → Calendar** | Events created in Peanuts appear in your calendar |
| **Calendar → Peanuts** | Calendar events are imported as entries           |
| **Two-way**            | Changes sync in both directions                   |

### Supported Calendars

<CardGroup cols={2}>
  <Card title="Google Calendar" icon="google">
    Full two-way sync support
  </Card>

  <Card title="Apple iCloud" icon="apple">
    Two-way sync via CalDAV
  </Card>

  <Card title="Microsoft Outlook" icon="microsoft">
    Full two-way sync support
  </Card>

  <Card title="CalDAV" icon="calendar">
    Any CalDAV-compatible calendar
  </Card>
</CardGroup>

## ICS File Format

The exported ICS files are standard iCalendar format, compatible with:

* Google Calendar
* Apple Calendar
* Microsoft Outlook
* Thunderbird
* Any standard calendar app

### What's Included

Each exported event contains:

* Event title from entry data
* Start and end times
* Description with entry details
* Location (if available)
* Reminders (configurable)

## Use Cases

<AccordionGroup>
  <Accordion title="Medication Reminders">
    Export your medication schedule to get calendar notifications for each dose.
  </Accordion>

  <Accordion title="Workout Schedule">
    Sync your planned workouts to see them alongside other commitments.
  </Accordion>

  <Accordion title="Project Deadlines">
    Export task deadlines from a Plan Helper to your work calendar.
  </Accordion>

  <Accordion title="Habit Tracking">
    Create calendar blocks for habits you want to build.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Events not syncing">
    * Check calendar authorization is still valid
    * Verify sync is enabled for the Helper
    * Try disconnecting and reconnecting
  </Accordion>

  <Accordion title="Duplicate events">
    * Check if two-way sync is creating duplicates
    * Disable Calendar → Peanuts if only exporting
  </Accordion>

  <Accordion title="ICS file won't import">
    * Ensure the file downloaded completely
    * Try a different calendar app
    * Check for special characters in event titles
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Schedule Template" icon="calendar-days" href="/templates/schedule">
    Create schedule-type Helpers
  </Card>

  <Card title="Ask Peanuts" icon="wand-magic-sparkles" href="/core-concepts/ask-peanuts">
    Generate calendar exports and more
  </Card>
</CardGroup>