Skip to content

Calendars Tools

Manage calendar entities and events in Home Assistant.

Available Tools

list_calendars

List all calendar entities.

Example Usage:

User: "What calendars do I have?"
Claude: [Uses list_calendars]
✅ Calendars:
- calendar.google (Google Calendar)
- calendar.local (Local Calendar)
...

get_calendar_events

Get events from a calendar for a date range.

Parameters: - entity_id (required): The calendar entity ID - start_date (required): Start date in ISO 8601 format (e.g., 2025-01-01 or 2025-01-01T00:00:00) - end_date (required): End date in ISO 8601 format

Example Usage:

User: "Show me events from calendar.google for the next week"
Claude: [Uses get_calendar_events]
✅ Calendar Events:
- 2025-01-16 10:00 - Meeting
- 2025-01-17 14:00 - Doctor Appointment
...

create_calendar_event

Create a new calendar event.

Parameters: - entity_id (required): The calendar entity ID - summary (required): Event title/summary - start (required): Start date/time in ISO 8601 format - end (required): End date/time in ISO 8601 format - description (optional): Event description

Example Usage:

User: "Create a calendar event for a meeting tomorrow at 10 AM"
Claude: [Uses create_calendar_event]
✅ Event created successfully:
   Title: Meeting
   Start: 2025-01-16T10:00:00
   End: 2025-01-16T11:00:00

Use Cases

Calendar Queries

"What events do I have today?"
"Show me calendar events for next week"
"List all events from calendar.google"

Event Management

"Create a calendar event for a doctor appointment tomorrow"
"Add an event to my calendar for the weekend"
"Create an all-day event for my birthday"

Date Formats

Dates can be provided in ISO 8601 format:

  • Date only: 2025-01-01 (for all-day events)
  • Date and time: 2025-01-01T10:00:00
  • With timezone: 2025-01-01T10:00:00+00:00

If only a date is provided, times default to: - Start: 00:00:00 - End: 23:59:59