Read events
events_listRead the events of a period across every connected calendar, earliest first, or latest first with newestFirst. query finds the events whose title, description, place, organizer or guests hold every word it names - a person by name or address included - on every account: Google searches its own, while Outlook, which searches titles alone, is read across the period and matched here. account, with provider where two share an address, reads that account alone, and calendarId, as calendars_list names it, that one of its calendars alone. Each event answers once, naming under copies every account and calendar holding it, with that copy's id, how it shows there and that account's own answer. An occurrence of a recurring series names under originalStart the start its series gave it, which a moved one keeps, and under each copy that account's seriesId. A calendar shared into one account from another connected account is read through its owner alone. Lumman's own busy copies - private blocks titled "Busy · (Multi Calendar connector)" - are never among the events: busyCopies answers them apart, one entry per copied busy time with its start and end, the account it copies under copyOf - unknown where no record of it stands - and each account it stands in under standsIn. None counts as the person's time or can be moved or cancelled; asked about one, say it is a busy copy of that account, switched off at https://lumman.co/mcp/account/multi-calendar or by taking that pair away with busy_everywhere_set. Every time is given with its offset in the zone the answer names under timeZone: the one passed, else the person's stored zone, which now names with their time now; an all-day event's start and end are dates, its end the day after its last. An answer, a guest's or an account's own, is accepted, tentative, declined, unanswered or organizer, and one a copy cannot know is left out. An event names its kind where it is no ordinary event - a Google outOfOffice, focusTime, workingLocation, birthday or fromGmail entry - its privacy where it is not normal: public, private, confidential or personal - and its Teams, Zoom or Meet join link, and each copy its webLink; an out-of-office event shows as away. A description is its first 255 characters, marked descriptionCut where it goes on: events_get reads it whole. Each calendar answers at most 50 events, read in time order; one with more is named under cutShort with its calendarId, readTo - the start of the last event read - and continueAt: pass that continueAt with its account and calendarId, the same period and query, to read on from exactly where it stopped; read latest first, such a calendar's latest events are the ones past readTo, so read it on before naming the latest. A calendar or an account that could not be read, or that the person does not let you see, is named under unread with why: needs_reconnection - reconnected at https://lumman.co/mcp/account/multi-calendar - not_allowed, refused, gone, rate_limited or unavailable; where nothing could be read the answer is an error. malformed counts events a provider sent in a form that could not be read, each left out. An event whose words screen as a prompt attack is left out and named under withheld by its start, its end and each copy's account, calendarId and id - by account alone where an id screened so - and a calendar whose name screened so is named by its account alone.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | End of the period, excluded, in the same forms. | |
| from | Yes | Start of the period, included: e.g. 2026-10-12, 2026-10-12T09:00 or 2026-10-12T09:00:00+01:00. | |
| query | No | Words, or a person by name or address, every one of which an event must hold. | |
| account | No | Read this connected account alone, by the address calendars_list names. | |
| provider | No | The account's provider, as calendars_list names it; needed only where two connected accounts share an address. | |
| timeZone | No | An IANA zone such as Europe/London to answer in; the person's stored one where omitted. | |
| calendarId | No | Read this calendar of the account named alone, by the calendarId calendars_list names. | |
| continueAt | No | Read on from where a calendar under cutShort was cut: its continueAt, with its account and calendarId. | |
| newestFirst | No | Answer the latest events first. |