Get all calendar events for today, grouped by calendar.

Get calendar events for the next N days, grouped by date.

Args: days: Number of days to look ahead (default 7).

List all calendars with their event counts.

Get full details for a specific event by its ID.

Args: event_id: The event ID (shown in parentheses in event listings).

Search events by title, location, notes, or attendees.

Args: query: Search term (supports FTS5 syntax: AND, OR, NOT, quotes for phrases). limit: Maximum number of results (default 20).

Get events from a specific calendar.

Args: calendar: Calendar name (e.g. "Work", "Personal"). Use get_calendars to see available names. days: Number of days to look ahead (default 30).

Get events in an arbitrary date window (past or future), grouped by date.

Specify the window in exactly ONE of two ways (not both):

• Absolute: pass both start and end as "YYYY-MM-DD". end is inclusive of the whole day (e.g. start="2026-05-28", end="2026-06-10" covers all of the 10th).

• Relative: pass days_back (a positive integer) for events from that many days ago through the end of today.

Args: calendar: Optional calendar name to scope to (use get_calendars for names). Omit to query all calendars — note that an event mirrored across several calendars then appears once per calendar; scope to a single calendar to get a clean, duplicate-free list. start: Absolute-mode start date, "YYYY-MM-DD". end: Absolute-mode end date, "YYYY-MM-DD" (inclusive). days_back: Relative-mode window size in days.

Show free/busy time slots for a specific date.

Args: date: Date in YYYY-MM-DD format. calendars: Optional list of calendar names to check. If omitted, checks all calendars.

List upcoming recurring events, optionally filtered by calendar.

Useful for understanding the regular schedule (standups, focus blocks, etc.).

Args: calendar: Optional calendar name to filter by. Use get_calendars to see available names. limit: Maximum number of results (default 50).

List pending event invitations that need a response.

Args: limit: Maximum number of results (default 20).

Show the most recently added or synced calendar events.

Useful for seeing what's new on the calendar without knowing specific dates.

Args: limit: Maximum number of results (default 10).

Create a new event in Fantastical using natural language.

Fantastical's parser handles dates, times, locations, and recurrence naturally. Examples: "Lunch with Sara tomorrow at noon at The Crafers Hotel", "Weekly team standup every Monday at 9am".

Args: sentence: Natural language event description. calendar: Optional calendar name to create the event in. add_immediately: If True, add without showing confirmation UI (default False).

Machine-readable variant of get_today.

Returns today's events as a structured dict so programmatic clients (dashboards, automations) don't have to parse the pretty-printed text output. Event times are ISO-8601 strings in the event's original timezone.

Response shape::

{
  "now": ISO-8601 string (current local time),
  "timezone": IANA name (e.g. "Australia/Adelaide"),
  "events": [{id, title, calendar, start, end, all_day,
              location, recurring, attendees_count}, ...]
}

Machine-readable variant of get_upcoming.

Args: days: Number of days to look ahead (default 7).

Response shape mirrors get_today_json but covers the next days days.

Machine-readable variant of get_event. Returns None-valued fields when a value is absent rather than omitting them, so clients can treat the shape as stable.

Args: event_id: The event rowid (as returned by get_today_json etc.).

Open Fantastical's mini calendar to a specific date.

Args: date: Date in YYYY-MM-DD format.