Get calendar events from Skylight.

Use this to answer questions like:

• "What's on my calendar today?"

• "What do we have scheduled this weekend?"

• "Are there any events on Friday?"

Returns a list of events with their titles, times, and details.

Get connected calendar sources synced to Skylight.

Use this to answer:

• "Which calendars are synced to Skylight?"

• "What calendar accounts are connected?"

Returns a list of connected calendar sources (Google, iCloud, etc.).

Create a new calendar event in Skylight.

Use this when:

• Scheduling a new event: "Add a dentist appointment on Friday at 2pm"

• Creating family activities: "Schedule soccer practice every Saturday at 10am"

• Adding reminders: "Put Mom's birthday on the calendar"

Parameters:

• summary (required): Event title (e.g., "Dentist Appointment")

• startsAt (required): Start time in ISO format or natural language

• endsAt (required): End time in ISO format or natural language

• allDay: Set to true for all-day events

• description: Additional notes for the event

• location: Where the event takes place

• categoryIds: Family member IDs to associate with the event

Returns: The created event details.

Related: Use get_family_members to get category IDs for assignments.

Update an existing calendar event.

Use this when:

• Changing event time: "Move the dentist appointment to 3pm"

• Updating event details: "Add location to the meeting"

• Renaming an event: "Change 'Doctor' to 'Dr. Smith checkup'"

Parameters:

• eventId (required): ID of the event to update (from get_calendar_events)

• summary: New title for the event

• startsAt: New start time (ISO format)

• endsAt: New end time (ISO format)

• description: Updated notes

• location: Updated location

• categoryIds: Updated family member assignments

Returns: The updated event details.

Delete a calendar event from Skylight.

Use this when:

• Canceling an event: "Remove the dentist appointment"

• Deleting old events: "Delete the meeting from yesterday"

Parameters:

• eventId (required): ID of the event to delete (from get_calendar_events)

Note: This permanently removes the event. For recurring events, this may only delete one instance.

Get chores from Skylight.

Use this to answer:

• "What chores do I need to do today?"

• "Show me this week's chores"

• "What's on the chore chart?"

• "What chores does [name] have?"

Returns chores with their IDs (needed for update_chore/delete_chore), assignees, due dates, and completion status.

Add a new chore to Skylight.

Use this when the user wants to:

• Add a new task like "empty the dishwasher"

• Assign chores to family members

• Create recurring chores

The chore will appear on the Skylight display. An assignee is required — this account's Skylight API version rejects unassigned ("up for grabs") chores outright, so there is no way to create one without an assignee.

Update an existing chore in Skylight.

Use this when:

• Marking a chore as complete: "Mark 'dishes' as done"

• Changing chore assignment: "Reassign the trash to Dad"

• Updating chore details: "Change the time for the homework chore"

• Shifting which day(s) a recurring chore falls on: "Move trash day to Wednesday"

Parameters:

• choreId (required): ID of the chore (from get_chores)

• summary: New description for the chore

• status: "completed" to mark done, "pending" to mark incomplete

• date: New due date. IMPORTANT: for a recurring chore, changing date alone does NOT shift which day(s) it recurs on — the API keeps generating occurrences on the old RRULE weekday regardless of the new date. To actually move a recurring chore's day, also pass recurrencePattern with a matching RRULE (e.g. date="2026-08-26" + recurrencePattern="RRULE:FREQ=WEEKLY;BYDAY=WE" to move it to Wednesdays), and pass applyTo.

• recurrencePattern: New recurrence rule for a recurring chore ('daily', 'weekly', 'weekdays', or a raw RRULE string like 'RRULE:FREQ=WEEKLY;BYDAY=WE'). Use this to actually change a recurring chore's day(s) — date alone won't do it.

• applyTo: Required for any change to a recurring chore, or the API silently ignores the whole update (200 response, nothing actually changes, no error). Not needed for one-off chores.

  • "all": apply to every occurrence of the series

  • "future": apply to this occurrence and every later one, past occurrences untouched

• time: New due time

• assignee: New family member assignment. There is no way to unassign a chore on this account (up_for_grabs is rejected by the API) — assignee can only be reassigned to another family member, never cleared.

Returns: The updated chore details. If any requested field didn't actually change (most commonly: a recurring chore updated without applyTo), this returns an error instead of a false "Updated" success, listing exactly which fields didn't take.

Delete a chore from Skylight.

Use this when:

• Removing an old or irrelevant chore

• Deleting a chore that was added by mistake

• Removing a recurring chore series, or ending it from a given date onward

Parameters:

• choreId (required): ID of the chore to delete (from get_chores)

• applyTo: Required for recurring chores, ignored for one-off chores.

  • "all": delete every occurrence of the recurring series

  • "future": delete this occurrence and every later one, keeping past occurrences intact There is no way to delete a single recurring occurrence while leaving later ones in place — the Skylight API only supports "all" or "future" for recurring chores.

Note: This permanently removes the chore(s). Deleting a recurring chore without applyTo will fail with an error asking for one.

Get all lists from Skylight (grocery lists, to-do lists, etc.).

Use this to see what lists are available before adding items. Returns list names, types (shopping/to_do), and item counts.

Get items from a specific Skylight list.

Use this to answer:

• "What's on the grocery list?"

• "Show me my to-do list"

• "What items are on [list name]?"

Returns items organized by section with their completion status.

Create a new list in Skylight.

Use this when:

• Creating a new shopping/grocery list

• Creating a new to-do list

Parameters:

• label (required): Name of the list (e.g., "Vacation Packing", "Weekly Groceries")

• kind (required): "shopping" for grocery/shopping lists, "to_do" for task lists

• color: Optional color for the list

Returns: The created list details.

Update an existing list's name or settings.

Use this when:

• Renaming a list

• Changing a list's type or color

Parameters:

• listId: ID of the list to update (use get_lists to find IDs)

• listName: Name of the list to update (alternative to listId)

• label: New name for the list

• kind: New type ("shopping" or "to_do")

• color: New color for the list

Returns: The updated list details.

Delete a list from Skylight.

Use this when:

• Removing an old or unused list

• Deleting a temporary list

Parameters:

• listId: ID of the list to delete (use get_lists to find IDs)

• listName: Name of the list to delete (alternative to listId)

Note: This permanently deletes the list and all its items.

Add an item to a Skylight list.

Use this when:

• Adding something to the grocery list: "Add milk to the shopping list"

• Creating a to-do item: "Put 'call doctor' on my to-do list"

• Adding items to any list

Parameters:

• label (required): The item text (e.g., "Milk", "Call doctor")

• listId: ID of the list to add to

• listName: Name of the list to add to (e.g., "Grocery List")

• section: Category within the list (e.g., "Dairy", "Produce")

If no list is specified, adds to the default grocery list.

Returns: Confirmation of the added item.

Related: Use get_lists to see available lists and their IDs.

Update a list item (mark complete, rename, move to section).

Use this when:

• Marking an item as complete: "Check off milk from the list"

• Renaming an item: "Change 'milk' to '2% milk'"

• Moving an item to a different section

Parameters:

• itemId (required): ID of the item to update

• listId (required): ID of the list containing the item

• label: New text for the item

• status: "completed" to check off, "pending" to uncheck

• section: Move to a different section

Returns: The updated item details.

Remove an item from a list.

Use this when:

• Removing an item that was added by mistake

• Deleting an item instead of marking it complete

Parameters:

• itemId (required): ID of the item to delete

• listId (required): ID of the list containing the item

Note: This permanently removes the item. Use update_list_item with status="completed" to check it off instead.

Add a task to the Skylight task box.

The task box holds unscheduled tasks that can later be assigned to specific dates.

Use this when the user says:

• "Add XYZ to my task list"

• "Remind me to do ABC" (without a specific date)

• "Put 'clean garage' on the task box"

The task will appear on the Skylight display in the task box.

Get family members/profiles from Skylight.

Shows who can be assigned chores and their profile details.

Use this to answer:

• "Who's in our family on Skylight?"

• "What family members are set up?"

• "Who can I assign chores to?"

Get Skylight household/frame information.

Useful for setup verification and debugging.

Use this to answer:

• "Show Skylight household info"

• "What's my frame ID?"

List Skylight devices in the household.

Use this to answer:

• "What Skylight devices do we have?"

• "How many Skylight frames are connected?"

Get available avatar options for Skylight profiles.

Use this when:

• Setting up a new family member profile

• Changing someone's profile picture

• Exploring available avatar options

Returns: List of available avatars with their IDs and details.

Get available color options for Skylight profiles and lists.

Use this when:

• Choosing a color for a family member profile

• Setting a list color

• Exploring available color options

Returns: List of available colors with their IDs and hex values.