Smart Calendars AI

Working · 2.4 s

ai.smartcalendars/smart-calendars-aiv2.0.0 Domain verified

Create and update subscription calendars from ChatGPT, Claude, or Codex.

Productivity

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.smartcalendars.ai/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

apply_feed_changes Destructive

Save one revision to one existing calendar feed owned by the connected account. Submit one fixed-schema change set with up to 250 event changes and/or a feed title or description change; all stored calendar changes commit together in one transaction, or none are saved. The input schema declares every supported change: add creates an event; update changes selected fields or uses reset_fields to restore saved field baselines; delete marks an existing event canceled without permanently erasing it; restore reinstates that same event and may update selected fields; feed_patch changes only the calendar title or description. No dynamic operation discovery, fetched schemas, arbitrary commands or arbitrary endpoints are supported. First use dry_run=true to validate and preview the change set without saving, advancing the revision or spending credits. Show the returned before/after changes and any billing quote, not an invented summary. Obtain approval for a proposed schedule revision before saving it with dry_run=false. Save with the returned preview_receipt and the identical feed_id, expected_revision, request_id, operations and feed_patch. The receipt binds that validated preview, not user consent. Changed proposals or expired previews require a new preview and approval; revision conflicts require reading the feed again before preparing a new preview. Preserve omitted events/fields. For revised PDFs/documents, read the complete unfiltered feed before cancellations, preserve unrelated events and manual fields, and ask when an event match is uncertain. Update matched event IDs; a duplicate add is not an update. Use set with null to clear nullable fields; reset_fields restores saved baselines, not empty values. Use the last read expected_revision to prevent overwriting concurrent changes. On uncertain save retry the identical request_id and payload, including the original preview_receipt, never a new one. Subscribers save without billing prompts. If billing requires one credit, show the deduction and balance and obtain explicit user authorization before setting confirm_credit_charge=true; this explicit authorization may be added after preview. Default automations must not authorize credit spending. publication.status reports calendar-file preparation, not subscription access. Check distribution_ready for access at the reported revision; use get_feed_status for current availability. Preview proposals are recoverable for up to one hour; expired drafts are removed automatically. Previewing does not write calendar events or advance their revision. Display the returned feed_id and request_id alongside the preview summary so this exact proposal can be recovered. If the receipt or exact proposal was lost, call this same tool with only feed_id, the original request_id, dry_run=true and recover_preview=true. Do not reconstruct missing changes from memory, guess a key or choose a latest preview. Recovery returns the original unexpired preview and exact save_arguments without extending its expiry, saving or spending credits. Show that recovered preview and obtain fresh approval before submitting its save_arguments unchanged; confirm_credit_charge remains false unless the user explicitly authorizes the current quoted charge. Recovery is not consent. If recovery returns saved=true, those changes were already saved: report that result and stop; do not submit a new save. If no recoverable preview remains, read the feed, prepare a new preview with a new request_id and obtain approval. Never silently substitute a changed proposal. These tools manage Smart Calendars feeds only; they cannot access mailboxes or start source monitoring, scheduled PDF checks or document refreshes. For requests solely for those unsupported actions, explain the limitation without reading feeds or substituting an edit. For unsupported mailbox requests, offer to work with schedule content the user chooses to provide instead. General ICS explanations need no account access. When sharing a feed or filtered_subscription with distribution_ready=true, offer "Open in calendar app" using that object’s HTTPS subscription_open_url (it redirects to webcal), and "Calendar options" using its subscription_options_url for Apple/default, Google, Outlook and copy-link choices. Retain subscription_url as a copyable HTTPS fallback. Prefer these HTTPS handoff links over putting subscription_webcal_url directly in chat, because some clients do not preserve clickable webcal links. If a handoff URL is absent, use the HTTPS subscription_url and dashboard subscription controls instead. Offer "View or edit" using the feed’s manage_url. For a filtered selection use the nested filtered_subscription links, not the unfiltered feed links. Use the returned URLs exactly; never invent or rewrite their host, path or token. Opening a link does not confirm a subscription; the user must confirm in their calendar app. Do not present inactive or unpublished feeds as ready to subscribe.

feed_idstring, required

Feed identity returned by a previous feed tool; used to address the selected calendar only.

request_idstring, required

Generate an opaque key for this save and reuse it unchanged for retries, to prevent duplicate changes. Not a user identifier, chat/session ID, or telemetry. Do not include personal data.

dry_runboolean

feed_patchobject

operationsarray

preview_receiptstring

Opaque receipt returned by a successful dry_run=true preview. Required when saving with dry_run=false. Return it unchanged with the same feed, revision, request_id and proposed changes. It is not user approval.

recover_previewboolean

Read the exact temporarily stored preview after losing its receipt or proposal. Requires dry_run=true and only feed_id and the original request_id; omit all other arguments. Does not save, extend expiry or authorize a charge. Show the recovered preview and obtain fresh approval before saving. Never guess a request ID or select a latest preview.

expected_revisioninteger

Last read feed revision; prevents overwriting concurrent edits.

confirm_credit_chargeboolean

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Try it

Call this server's tools from your browser. Nothing to install.

https://api.smartcalendars.ai/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

apply_feed_changes Destructive

feed_idstring, required

Feed identity returned by a previous feed tool; used to address the selected calendar only.

request_idstring, required

Generate an opaque key for this save and reuse it unchanged for retries, to prevent duplicate changes. Not a user identifier, chat/session ID, or telemetry. Do not include personal data.

dry_runboolean

feed_patchobject

operationsarray

preview_receiptstring

recover_previewboolean

expected_revisioninteger

Last read feed revision; prevents overwriting concurrent edits.

confirm_credit_chargeboolean

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Tools (7)

apply_feed_changes

destructive

Argument	Type	Description
dry_run	boolean
feed_id*	string	Feed identity returned by a previous feed tool; used to address the selected calendar only.
feed_patch	object
operations	array
request_id*	string	Generate an opaque key for this save and reuse it unchanged for retries, to prevent duplicate changes. Not a user identifier, chat/session ID, or telemetry. Do not include personal data.
preview_receipt	string	Opaque receipt returned by a successful dry_run=true preview. Required when saving with dry_run=false. Return it unchanged with the same feed, revision, request_id and proposed changes. It is not user approval.
recover_preview	boolean	Read the exact temporarily stored preview after losing its receipt or proposal. Requires dry_run=true and only feed_id and the original request_id; omit all other arguments. Does not save, extend expiry or authorize a charge. Show the recovered preview and obtain fresh approval before saving. Never guess a request ID or select a latest preview.
expected_revision	integer	Last read feed revision; prevents overwriting concurrent edits.
confirm_credit_charge	boolean

Input schema (JSON)

create_feed

Create and activate a subscription calendar from structured events. Extract the schedule yourself first. Free within feed allowances. No automatic monitoring is enrolled. Reuse request_id on retries. publication.status reports calendar-file preparation, not subscription access. Check distribution_ready for access at the reported revision; use get_feed_status for current availability. These tools manage Smart Calendars feeds only; they cannot access mailboxes or start source monitoring, scheduled PDF checks or document refreshes. For requests solely for those unsupported actions, explain the limitation without reading feeds or substituting an edit. For unsupported mailbox requests, offer to work with schedule content the user chooses to provide instead. General ICS explanations need no account access. When sharing a feed or filtered_subscription with distribution_ready=true, offer "Open in calendar app" using that object’s HTTPS subscription_open_url (it redirects to webcal), and "Calendar options" using its subscription_options_url for Apple/default, Google, Outlook and copy-link choices. Retain subscription_url as a copyable HTTPS fallback. Prefer these HTTPS handoff links over putting subscription_webcal_url directly in chat, because some clients do not preserve clickable webcal links. If a handoff URL is absent, use the HTTPS subscription_url and dashboard subscription controls instead. Offer "View or edit" using the feed’s manage_url. For a filtered selection use the nested filtered_subscription links, not the unfiltered feed links. Use the returned URLs exactly; never invent or rewrite their host, path or token. Opening a link does not confirm a subscription; the user must confirm in their calendar app. Do not present inactive or unpublished feeds as ready to subscribe.

Argument	Type	Description
title*	string
events*	array
activate	boolean

deactivate_feed

Deactivate a feed without deleting events or resetting editing windows. Confirm the user wants to interrupt subscription access. publication.status reports calendar-file preparation, not subscription access. Check distribution_ready for access at the reported revision; use get_feed_status for current availability. These tools manage Smart Calendars feeds only; they cannot access mailboxes or start source monitoring, scheduled PDF checks or document refreshes. For requests solely for those unsupported actions, explain the limitation without reading feeds or substituting an edit. For unsupported mailbox requests, offer to work with schedule content the user chooses to provide instead. General ICS explanations need no account access. When sharing a feed or filtered_subscription with distribution_ready=true, offer "Open in calendar app" using that object’s HTTPS subscription_open_url (it redirects to webcal), and "Calendar options" using its subscription_options_url for Apple/default, Google, Outlook and copy-link choices. Retain subscription_url as a copyable HTTPS fallback. Prefer these HTTPS handoff links over putting subscription_webcal_url directly in chat, because some clients do not preserve clickable webcal links. If a handoff URL is absent, use the HTTPS subscription_url and dashboard subscription controls instead. Offer "View or edit" using the feed’s manage_url. For a filtered selection use the nested filtered_subscription links, not the unfiltered feed links. Use the returned URLs exactly; never invent or rewrite their host, path or token. Opening a link does not confirm a subscription; the user must confirm in their calendar app. Do not present inactive or unpublished feeds as ready to subscribe.

destructive

Argument	Type	Description
feed_id*	string	Feed identity returned by a previous feed tool; used to address the selected calendar only.
request_id*	string

get_feed

Read events and the internal revision before editing. Request include_facets first and select returned values for known labels. Facet results 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. Use its URLs for 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. Before proposing cancellations from a revised PDF/document, read every page of the unfiltered feed; never infer deletion from omitted events. These tools manage Smart Calendars feeds only; they cannot access mailboxes or start source monitoring, scheduled PDF checks or document refreshes. For requests solely for those unsupported actions, explain the limitation without reading feeds or substituting an edit. For unsupported mailbox requests, offer to work with schedule content the user chooses to provide instead. General ICS explanations need no account access. When sharing a feed or filtered_subscription with distribution_ready=true, offer "Open in calendar app" using that object’s HTTPS subscription_open_url (it redirects to webcal), and "Calendar options" using its subscription_options_url for Apple/default, Google, Outlook and copy-link choices. Retain subscription_url as a copyable HTTPS fallback. Prefer these HTTPS handoff links over putting subscription_webcal_url directly in chat, because some clients do not preserve clickable webcal links. If a handoff URL is absent, use the HTTPS subscription_url and dashboard subscription controls instead. Offer "View or edit" using the feed’s manage_url. For a filtered selection use the nested filtered_subscription links, not the unfiltered feed links. Use the returned URLs exactly; never invent or rewrite their host, path or token. Opening a link does not confirm a subscription; the user must confirm in their calendar app. Do not present inactive or unpublished feeds as ready to subscribe. When returning a filtered subscription, explain: filters select events, not who can access them; anyone with the link can remove the filters and read the full published calendar.

read-only

Argument	Type

get_feed_status

Read the feed’s last update, subscription availability (distribution_ready), editing access and configured monitoring status. This does not refresh or charge. These tools manage Smart Calendars feeds only; they cannot access mailboxes or start source monitoring, scheduled PDF checks or document refreshes. For requests solely for those unsupported actions, explain the limitation without reading feeds or substituting an edit. For unsupported mailbox requests, offer to work with schedule content the user chooses to provide instead. General ICS explanations need no account access. When sharing a feed or filtered_subscription with distribution_ready=true, offer "Open in calendar app" using that object’s HTTPS subscription_open_url (it redirects to webcal), and "Calendar options" using its subscription_options_url for Apple/default, Google, Outlook and copy-link choices. Retain subscription_url as a copyable HTTPS fallback. Prefer these HTTPS handoff links over putting subscription_webcal_url directly in chat, because some clients do not preserve clickable webcal links. If a handoff URL is absent, use the HTTPS subscription_url and dashboard subscription controls instead. Offer "View or edit" using the feed’s manage_url. For a filtered selection use the nested filtered_subscription links, not the unfiltered feed links. Use the returned URLs exactly; never invent or rewrite their host, path or token. Opening a link does not confirm a subscription; the user must confirm in their calendar app. Do not present inactive or unpublished feeds as ready to subscribe.

read-only

Argument	Type	Description
feed_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "feed_id"
  ],
  "properties": {
    "feed_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

list_feeds

List the connected account’s feeds, management links and shared active-feed allowance. Only feeds marked counts_towards_active_limit use a slot; this page’s length is not the account’s usage. Deactivating a counted feed frees a slot but interrupts its subscription access, so ask the user first. These tools manage Smart Calendars feeds only; they cannot access mailboxes or start source monitoring, scheduled PDF checks or document refreshes. For requests solely for those unsupported actions, explain the limitation without reading feeds or substituting an edit. For unsupported mailbox requests, offer to work with schedule content the user chooses to provide instead. General ICS explanations need no account access. When sharing a feed or filtered_subscription with distribution_ready=true, offer "Open in calendar app" using that object’s HTTPS subscription_open_url (it redirects to webcal), and "Calendar options" using its subscription_options_url for Apple/default, Google, Outlook and copy-link choices. Retain subscription_url as a copyable HTTPS fallback. Prefer these HTTPS handoff links over putting subscription_webcal_url directly in chat, because some clients do not preserve clickable webcal links. If a handoff URL is absent, use the HTTPS subscription_url and dashboard subscription controls instead. Offer "View or edit" using the feed’s manage_url. For a filtered selection use the nested filtered_subscription links, not the unfiltered feed links. Use the returned URLs exactly; never invent or rewrite their host, path or token. Opening a link does not confirm a subscription; the user must confirm in their calendar app. Do not present inactive or unpublished feeds as ready to subscribe.

read-only

Argument	Type	Description
limit	integer
offset	integer

Input schema (JSON)

reactivate_feed

Reactivate an existing feed free within account allowances. Does not reset the original editing window or modify events. publication.status reports calendar-file preparation, not subscription access. Check distribution_ready for access at the reported revision; use get_feed_status for current availability. These tools manage Smart Calendars feeds only; they cannot access mailboxes or start source monitoring, scheduled PDF checks or document refreshes. For requests solely for those unsupported actions, explain the limitation without reading feeds or substituting an edit. For unsupported mailbox requests, offer to work with schedule content the user chooses to provide instead. General ICS explanations need no account access. When sharing a feed or filtered_subscription with distribution_ready=true, offer "Open in calendar app" using that object’s HTTPS subscription_open_url (it redirects to webcal), and "Calendar options" using its subscription_options_url for Apple/default, Google, Outlook and copy-link choices. Retain subscription_url as a copyable HTTPS fallback. Prefer these HTTPS handoff links over putting subscription_webcal_url directly in chat, because some clients do not preserve clickable webcal links. If a handoff URL is absent, use the HTTPS subscription_url and dashboard subscription controls instead. Offer "View or edit" using the feed’s manage_url. For a filtered selection use the nested filtered_subscription links, not the unfiltered feed links. Use the returned URLs exactly; never invent or rewrite their host, path or token. Opening a link does not confirm a subscription; the user must confirm in their calendar app. Do not present inactive or unpublished feeds as ready to subscribe.

Argument	Type	Description
feed_id*	string	Feed identity returned by a previous feed tool; used to address the selected calendar only.
request_id*	string	Generate an opaque key for this save and reuse it unchanged for retries, to prevent duplicate changes. Not a user identifier, chat/session ID, or telemetry. Do not include personal data.

{ "type": "object", "required": [ "feed_id", "request_id" ], "properties": { "dry_run": { "type": "boolean", "default": false }, "feed_id": { "type": "string", "format": "uuid", "description": "Feed identity returned by a previous feed tool; used to address the selected calendar only." }, "feed_patch": { "type": "object", "required": [], "properties": { "title": { "type": "string" }, "description": { "type": [ "string", "null" ] } }, "additionalProperties": false }, "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "required": [ "op", "event" ], "properties": { "op": { "const": "add" }, "event": { "type": "object", "required": [ "title", "start_date", "is_all_day" ], "properties": { "title": { "type": [ "string", "null" ], "maxLength": 20000 }, "assignee": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile." }, "end_date": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise." }, "end_time": { "type": [ "string", "null" ], "maxLength": 20000 }, "location": { "type": [ "string", "null" ], "maxLength": 20000, "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation." }, "timezone": { "type": [ "string", "null" ], "maxLength": 20000 }, "is_all_day": { "type": "boolean" }, "start_date": { "type": [ "string", "null" ], "maxLength": 20000 }, "start_time": { "type": [ "string", "null" ], "maxLength": 20000 }, "description": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context." }, "facet_topic": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." }, "facet_venue": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." }, "facet_actors": { "type": [ "array", "null" ], "items": { "type": "string" }, "maxItems": 50, "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." } }, "additionalProperties": false }, "external_key": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,64}:[^\\s\\u0000-\\u001f]{1,190}$", "maxLength": 255, "minLength": 3, "description": "Source-stable, namespaced event identity, for example school-a:session-104. Do not derive it from a mutable title or date. A duplicate add does not update the event; use its event_id with update." } }, "additionalProperties": false }, { "type": "object", "required": [ "op", "event_id" ], "properties": { "op": { "const": "update" }, "set": { "type": "object", "required": [], "properties": { "title": { "type": [ "string", "null" ], "maxLength": 20000 }, "assignee": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile." }, "end_date": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise." }, "end_time": { "type": [ "string", "null" ], "maxLength": 20000 }, "location": { "type": [ "string", "null" ], "maxLength": 20000, "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation." }, "timezone": { "type": [ "string", "null" ], "maxLength": 20000 }, "is_all_day": { "type": "boolean" }, "start_date": { "type": [ "string", "null" ], "maxLength": 20000 }, "start_time": { "type": [ "string", "null" ], "maxLength": 20000 }, "description": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context." }, "facet_topic": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." }, "facet_venue": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." }, "facet_actors": { "type": [ "array", "null" ], "items": { "type": "string" }, "maxItems": 50, "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." } }, "description": "Change only the supplied fields. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.", "additionalProperties": false }, "event_id": { "type": "string", "format": "uuid" }, "reset_fields": { "type": "array", "items": { "enum": [ "title", "description", "location", "start_date", "end_date", "start_time", "end_time", "timezone", "assignee", "facet_venue", "facet_topic", "is_all_day", "facet_actors" ] }, "minItems": 1, "description": "Remove selected overrides and restore their saved baseline. This does not clear fields: location Court 1 changed to Court 2 resets to Court 1. A field without an override stays unchanged, including values supplied when adding the event. To clear a nullable field use set with null. Do not include a field in both set and reset_fields.", "uniqueItems": true } }, "additionalProperties": false }, { "type": "object", "required": [ "op", "event_id" ], "properties": { "op": { "const": "delete" }, "event_id": { "type": "string", "format": "uuid" } }, "additionalProperties": false }, { "type": "object", "required": [ "op", "event_id" ], "properties": { "op": { "const": "restore" }, "set": { "type": "object", "required": [], "properties": { "title": { "type": [ "string", "null" ], "maxLength": 20000 }, "assignee": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile." }, "end_date": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise." }, "end_time": { "type": [ "string", "null" ], "maxLength": 20000 }, "location": { "type": [ "string", "null" ], "maxLength": 20000, "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation." }, "timezone": { "type": [ "string", "null" ], "maxLength": 20000 }, "is_all_day": { "type": "boolean" }, "start_date": { "type": [ "string", "null" ], "maxLength": 20000 }, "start_time": { "type": [ "string", "null" ], "maxLength": 20000 }, "description": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context." }, "facet_topic": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." }, "facet_venue": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." }, "facet_actors": { "type": [ "array", "null" ], "items": { "type": "string" }, "maxItems": 50, "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." } }, "description": "Change only the supplied fields. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.", "additionalProperties": false }, "event_id": { "type": "string", "format": "uuid" } }, "additionalProperties": false } ] }, "maxItems": 250 }, "request_id": { "type": "string", "pattern": "^[A-Za-z0-9:_.-]+$", "maxLength": 160, "minLength": 1, "description": "Generate an opaque key for this save and reuse it unchanged for retries, to prevent duplicate changes. Not a user identifier, chat/session ID, or telemetry. Do not include personal data." }, "preview_receipt": { "type": "string", "maxLength": 2048, "minLength": 1, "description": "Opaque receipt returned by a successful dry_run=true preview. Required when saving with dry_run=false. Return it unchanged with the same feed, revision, request_id and proposed changes. It is not user approval." }, "recover_preview": { "type": "boolean", "default": false, "description": "Read the exact temporarily stored preview after losing its receipt or proposal. Requires dry_run=true and only feed_id and the original request_id; omit all other arguments. Does not save, extend expiry or authorize a charge. Show the recovered preview and obtain fresh approval before saving. Never guess a request ID or select a latest preview." }, "expected_revision": { "type": "integer", "minimum": 0, "description": "Last read feed revision; prevents overwriting concurrent edits." }, "confirm_credit_charge": { "type": "boolean", "default": false } }, "additionalProperties": false }

{ "type": "object", "required": [ "request_id", "title", "events" ], "properties": { "title": { "type": "string", "maxLength": 20000 }, "events": { "type": "array", "items": { "type": "object", "required": [ "event" ], "properties": { "event": { "type": "object", "required": [ "title", "start_date", "is_all_day" ], "properties": { "title": { "type": [ "string", "null" ], "maxLength": 20000 }, "assignee": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile." }, "end_date": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise." }, "end_time": { "type": [ "string", "null" ], "maxLength": 20000 }, "location": { "type": [ "string", "null" ], "maxLength": 20000, "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation." }, "timezone": { "type": [ "string", "null" ], "maxLength": 20000 }, "is_all_day": { "type": "boolean" }, "start_date": { "type": [ "string", "null" ], "maxLength": 20000 }, "start_time": { "type": [ "string", "null" ], "maxLength": 20000 }, "description": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context." }, "facet_topic": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." }, "facet_venue": { "type": [ "string", "null" ], "maxLength": 20000, "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." }, "facet_actors": { "type": [ "array", "null" ], "items": { "type": "string" }, "maxItems": 50, "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields." } }, "additionalProperties": false }, "external_key": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,64}:[^\\s\\u0000-\\u001f]{1,190}$", "maxLength": 255, "minLength": 3, "description": "Source-stable, namespaced event identity, for example school-a:session-104. Do not derive it from a mutable title or date. A duplicate add does not update the event; use its event_id with update." } }, "additionalProperties": false }, "maxItems": 250, "minItems": 1 }, "activate": { "type": "boolean", "default": true }, "request_id": { "type": "string", "pattern": "^[A-Za-z0-9:_.-]+$", "maxLength": 160, "minLength": 1, "description": "Generate an opaque key for this save and reuse it unchanged for retries, to prevent duplicate changes. Not a user identifier, chat/session ID, or telemetry. Do not include personal data." }, "description": { "type": [ "string", "null" ], "maxLength": 20000, "description": "A short description of this calendar, not the conversation or user profile." } }, "additionalProperties": false }

{ "type": "object", "required": [ "feed_id" ], "properties": { "to": { "type": "string" }, "from": { "type": "string" }, "limit": { "type": "integer", "maximum": 250, "minimum": 1 }, "offset": { "type": "integer", "minimum": 0 }, "feed_id": { "type": "string", "format": "uuid" }, "filters": { "type": "object", "required": [], "properties": { "city": { "type": "array", "items": { "type": "string", "maxLength": 1000, "minLength": 1 }, "maxItems": 20, "minItems": 1, "description": "An existing event-city facet selected from available_facets.city. Not the user’s current city or residence; never request user geolocation." }, "topic": { "type": "array", "items": { "type": "string", "maxLength": 1000, "minLength": 1 }, "maxItems": 20, "minItems": 1 }, "venue": { "type": "array", "items": { "type": "string", "maxLength": 1000, "minLength": 1 }, "maxItems": 20, "minItems": 1, "description": "An event venue selected from available_facets.venue, not a user-location lookup." }, "format": { "type": "array", "items": { "type": "string", "maxLength": 1000, "minLength": 1 }, "maxItems": 20, "minItems": 1 }, "person": { "type": "array", "items": { "type": "string", "maxLength": 1000, "minLength": 1 }, "maxItems": 20, "minItems": 1, "description": "An event participant or organizer from available_facets.person, not an account or profile lookup." }, "source": { "type": "array", "items": { "type": "string", "maxLength": 1000, "minLength": 1 }, "maxItems": 20, "minItems": 1, "description": "Child-feed/source identifier from available_facets.source, not a source URL." }, "country": { "type": "array", "items": { "type": "string", "maxLength": 1000, "minLength": 1 }, "maxItems": 20, "minItems": 1, "description": "An existing event-country facet selected from available_facets.country. Not the user’s nationality or residence; never request user geolocation." }, "organizer": { "type": "array", "items": { "type": "string", "maxLength": 1000, "minLength": 1 }, "maxItems": 20, "minItems": 1, "description": "Alias for person." }, "attendance_mode": { "type": "array", "items": { "type": "string", "maxLength": 1000, "minLength": 1 }, "maxItems": 20, "minItems": 1, "description": "Alias for format." } }, "description": "Request include_facets first; use returned available_facets values for the desired known labels. 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.", "additionalProperties": false }, "event_ids": { "type": "array", "items": { "type": "string", "format": "uuid" }, "maxItems": 250 }, "external_keys": { "type": "array", "items": { "type": "string" }, "maxItems": 250 }, "removal_state": { "enum": [ "active", "removed", "all" ] }, "include_facets": { "type": "boolean", "default": false, "description": "Return 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. Also returned for nonempty filters. Canonical fields: person, venue, topic, city, country, format, source." } }, "additionalProperties": false }

to	string
from	string
limit	integer
offset	integer
feed_id*	string
filters	object	Request include_facets first; use returned available_facets values for the desired known labels. 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	array
external_keys	array
removal_state	any
include_facets	boolean	Return 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. Also returned for nonempty filters. Canonical fields: person, venue, topic, city, country, format, source.