Skip to content

Calendar Daemon

Google Calendar integration via Google API.

Installation

fgp install calendar
fgp start calendar

Authentication

Uses OAuth2, same flow as Gmail daemon.

Methods

calendar.today

Get today's events.

{
  "method": "calendar.today",
  "params": {}
}

calendar.upcoming

Get upcoming events.

{
  "method": "calendar.upcoming",
  "params": {
    "days": 7
  }
}

calendar.search

Search for events.

{
  "method": "calendar.search",
  "params": {
    "query": "meeting"
  }
}

calendar.free_slots

Find free time slots.

{
  "method": "calendar.free_slots",
  "params": {
    "duration_minutes": 30,
    "days": 3
  }
}

calendar.create

Create a new event.

{
  "method": "calendar.create",
  "params": {
    "title": "Team Meeting",
    "start": "2025-01-15T10:00:00",
    "end": "2025-01-15T11:00:00"
  }
}

CLI Examples

# Today's schedule
fgp call calendar today

# Find free time
fgp call calendar free_slots --duration 30

# Create event
fgp call calendar create --title "Meeting" --start "2025-01-15T10:00:00"

Status

Beta - Core operations work.