Calendar Events
get_eventsAuthenticated user's calendar events. Prefer explicit from/to (YYYY-MM-DD). Shortcuts: today|week|month|year (calendar year)|decade. Browsing noise excluded by default. Records carry inspect_url (their Dayze page): cite with it, never build a link from an id; a record without one has no page (inspect_note says which). ($0.10; API key required)
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | ISO date-time to answer as of (default now), e.g. 2026-09-26T09:00:00+08:00. | |
| to | No | Inclusive YYYY-MM-DD | |
| from | No | Inclusive YYYY-MM-DD (preferred over range) | |
| kinds | No | Filter by event_kind: life_event, calendar_block, todo, goal, travel_segment, food_log, health_record, transaction, media_log, work, family, personal. Alias "food" (also meal/drink/snack) matches the displayed Food category: food_log rows plus Meal/Drink/Snack life_events. total/has_more count only matching rows. | |
| limit | No | Maximum rows to return, e.g. 20. | |
| query | No | Literal substring in title, description or location. | |
| range | No | Shortcut window instead of from and to: today, week, month, year, decade or all, e.g. week. | |
| cursor | No | Opaque pagination cursor from the previous page's next_cursor, e.g. eyJvIjoyMH0. | |
| offset | No | Skip this many matching rows of a new snapshot (a cursor carries its own). | |
| date_to | No | Alias for to. | |
| timezone | No | IANA time zone for today (default: where the user is now, else their home zone). | |
| date_from | No | Alias for from. | |
| redact_pii | No | true: redact contact details, card and account numbers and secrets in description, location and scoreboard, even where this connection may see them. Never unredacts: without travel_secrets:read they are always redacted. | |
| event_kinds | No | Alias for kinds. | |
| include_archived | No | Include archived rows, e.g. false. | |
| include_browsing | No | Include extension "Browsed domain · Xm" auto-events (default false) | |
| include_calendar_blocks | No | Include Focus Time / calendar_block rows (default false) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Inclusive YYYY-MM-DD upper bound; null for all records. | |
| cap | Yes | ||
| from | Yes | Inclusive YYYY-MM-DD lower bound; null for all records. | |
| range | Yes | ||
| total | No | ||
| events | Yes | ||
| account | No | The Dayze account this data belongs to. With more than one Dayze connection, name it in the answer. | |
| has_more | No | ||
| ordering | No | ||
| timezone | Yes | Resolved timezone used for this event window and as fallback for rows without one. | |
| truncated | Yes | ||
| expires_at | No | ||
| next_cursor | No | ||
| server_time | No | ||
| snapshot_at | No | ||
| snapshot_id | No | ||
| inspect_note | No | How to cite: link each record with its inspect_url, never a link built from an id; which record types here have no Dayze page. |