Skip to content

Docs / All tools / Loop III: Assistant

apple_calendar.list_events

List Apple Calendar events within a date range.

2 credits. Per call.

Example prompt

Send this to your AI app when Heelo is connected:

What meetings do I have tomorrow?

Input fields

FieldTypeDescription
querystringNatural-language time range.
timezonestringIANA timezone override.
startstringExplicit RFC3339 start.
endstringExplicit RFC3339 end.
max_resultsintegerMaximum number of events to return.

Output fields

The fields in data when status is success.

FieldTypeDescription
rangeobjectResolved calendar query range.
countintegerNumber of events returned.
eventsarray of objectCalendar events.
interpretationstringHuman-readable time interpretation.
timezone_notestringSet when the range's zone is a fallback: tell the user.

Code

The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.

import os
import requests

response = requests.post(
    "https://toolsprimitives.uk/v1/tools/apple_calendar.list_events/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "query": "What meetings do I have tomorrow?",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())