Read calendar events
get_feedReads events and the current revision of a selected feed for a requested schedule lookup or revision. include_facets=true provides known facet values for label selection. Facets describe the entire published active feed, independent of read filters or pagination. Nonempty filters also return filtered_subscription with canonical filters, matching_event_count and unmatched_filter_values. Its nested URLs address that selection; top-level subscription URLs remain unfiltered. Event IDs, external keys, dates, removal state and pagination narrow only the read, never the subscription. Filtering changes no events and creates no cloned feed. A complete unfiltered read is a prerequisite for assessing cancellations from a revised schedule; omission from a filtered or paginated result is not evidence of deletion. Scope is limited to the connected account’s Smart Calendars AI feeds. No mailbox access, source-document retrieval, automatic source monitoring, scheduled PDF checks or document refresh is provided. Structured schedule content is supplied explicitly by the caller. Result links: subscription_open_url is the exact HTTPS handoff to the default calendar app via webcal; subscription_options_url provides Apple/default, Google, Outlook and copy-link choices; subscription_url is the copyable HTTPS calendar-file fallback; manage_url opens the feed dashboard. URL hosts, paths and tokens identify the returned resource and are not interchangeable. A filtered_subscription has its own links for that selection; top-level links remain unfiltered. Subscription access requires distribution_ready=true. Opening a link does not confirm a subscription; confirmation occurs in the user’s calendar app. Filter privacy: filters select events, not who can access them; anyone with the link can remove the filters and read the full published calendar.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"feed_id": "<feed_id>"
},
"name": "get_feed"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive upper date bound in YYYY-MM-DD format. Events whose date span overlaps the requested range can match; omission leaves the upper bound open. | |
| from | No | Inclusive lower date bound in YYYY-MM-DD format. Events whose date span overlaps the requested range can match; omission leaves the lower bound open. | |
| limit | No | Maximum events returned on this page, from 1 to 250; defaults to 100. | |
| offset | No | Number of matching results skipped before this page; defaults to 0. The response next_offset identifies the next page when present. | |
| feed_id | Yes | Identity of the selected calendar returned in feed results. | |
| filters | No | Values identify known labels from available_facets; include_facets=true provides that vocabulary. Values are trimmed and case-insensitive; format accepts attendance-mode aliases. Values within a field use OR; different fields use AND. Unknown values never broaden the selection. Filtering cannot infer missing metadata. | |
| event_ids | No | Optional selection of up to 250 existing event IDs. Omitted or empty means no event-ID restriction. This narrows only the read. | |
| external_keys | No | Optional selection of up to 250 source-stable external keys. Omitted or empty means no external-key restriction. Combined with other read filters. | |
| removal_state | No | Event cancellation state to return: active excludes canceled events, removed returns canceled events, and all includes both. Defaults to active. | |
| include_facets | No | Includes available_facets ({value,label,count} entries), facet_coverage ({tagged_events,fallback_events,missing_events}), facets_truncated and facet_scope=published_active_events. Coverage distinguishes explicit tags, fallbacks and missing values; title/location fallbacks do not infer classifications or audiences. Nonempty filters also include these results. Canonical fields: person, venue, topic, city, country, format, source. |