Get Calendar Events
ha_config_get_calendar_eventsRetrieve calendar events from a Home Assistant calendar entity within a specified time range. Returns summaries, times, descriptions, locations, and UIDs needed to edit or remove events.
Instructions
Get calendar events from a calendar entity within a time range.
Returns each event's summary, start, end, description and location, plus the uid, recurrence_id and rrule when the calendar provides them (the edit and remove tools use uid and recurrence_id). To find calendar entities, use ha_search(domain_filter='calendar').
EXAMPLES:
Next week (defaults): ha_config_get_calendar_events("calendar.family")
Date range: ha_config_get_calendar_events("calendar.work", start="2024-01-01T00:00:00", end="2024-01-31T23:59:59")
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"entity_id": "<entity_id>"
},
"name": "ha_config_get_calendar_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | End datetime in ISO format (default: 7 days from now, not from start; pass end whenever you pass start) | |
| start | No | Start datetime in ISO format; omit it to start at the current time | |
| entity_id | Yes | Calendar entity ID (e.g., 'calendar.family') | |
| max_results | No | Maximum number of events to return |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||