Get Calendar Events
ha_config_get_calendar_eventsRead-onlyIdempotent
Retrieve calendar events from any Home Assistant calendar entity, with customizable start and end times and a maximum result limit.
Instructions
Retrieve calendar events from a calendar entity.
Retrieves calendar events within a specified time range.
Parameters:
entity_id: Calendar entity ID (e.g., 'calendar.family')
start: Start datetime in ISO format (default: now)
end: End datetime in ISO format (default: 7 days from start)
max_results: Maximum number of events to return (default: 20)
Example Usage:
# Get events for the next week
events = ha_config_get_calendar_events("calendar.family")
# Get events for a specific date range
events = ha_config_get_calendar_events(
"calendar.work",
start="2024-01-01T00:00:00",
end="2024-01-31T23:59:59"
)Note: To find calendar entities, use ha_search(query='calendar', domain_filter='calendar')
Returns:
List of calendar events with summary, start, end, description, location
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | End datetime in ISO format (default: 7 days from start) | |
| start | No | Start datetime in ISO format (default: now) | |
| entity_id | Yes | Calendar entity ID (e.g., 'calendar.family') | |
| max_results | No | Maximum number of events to return |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||