Glance

Attaches a Glance source to a feed. Copy integration_id from list_integrations. Do not invent ids. On-device sources (type device, such as weatherkit, eventkit_calendar, eventkit_reminders, coremotion) omit schedule_cron and connection_id. BEFORE calling one of those: tell the user to open Glance → Settings → Connected Services and tap Connect on that source. Wait until they confirm. You cannot grant iOS permissions from this chat. Cloud catalog sources (type cloud, such as google_calendar or github) need schedule_cron. Check list_connected_integrations for that entry's providerId first. If it is missing, send the user to Connected Services and wait. Pass connection_id only when that provider has more than one active connection. field_mapping values are field ids from list_integrations. When a config option is selectable, call list_integration_assets. Custom URL: integration_id custom_connection, custom_connection_id, and schedule_cron. JSON field_mapping is required. Keys are widget binding names. Values are paths copied from the preview, for example {"temperature":"current.temperature_2m"} or {"price":"c"}. The right-hand side is the preview path, not the widget label, unless those strings are the same. An empty map is rejected for JSON. RSS may use {} when the bindings are the slot ids. Do not send them to Connected Services to tap Connect. A public feed is already saved. A keyed feed waits on the app link until they paste the key. An id that is not in list_integrations is not a Glance connector. Fetch with your tools, then ingest. Layout bindings: current_temp / reminder_1_* / event_1_* for lists, or {{events}} on a v2 calendar node (eventkit_calendar, field_mapping {}). Reminders stay lists. After success: ingest once with template_id so the layout attaches, then tell them to open Glance once and pin. Device sources do not write feed_state, so those placeholders stay until the phone overwrites them. A cloud source or a custom URL then updates on its schedule. Do not ingest over it on a timer.

create_automation

Saves a URL Glance can fetch for a widget. RSS or JSON. No secret argument. Never put a key in the URL or in chat. If capabilities.custom_connections is false, do not call this. When status is needs_key, send the user appLink and wait. Do not design the widget yet.

create_custom_connection

Creates a new Glance widget template and saves it to the database. Server-side structural validation is the save gate (unknown types, bindings, depth, ids). Design issues (padding, overflow, style keys) are warnings only and do not block create. If structural validation fails, fix the tree and retry create_template — validate_template is optional. Pro+ families (chart, grid, table, views/action) 403 PREMIUM_FAMILY_REQUIRED — call get_plan first. Returns the created template with its ID.

create_template

Creates a dynamic widget config + coupled feed. Returns config.id, feed.id, ingest URL, and write_key once. The write key is for Shortcuts/Make/curl only — ChatGPT/Claude must call ingest with OAuth and must not store the key. Ask list_widgets before creating. Size must match the template widget_size.

create_dynamic_widget

Permanently deletes a widget config and its feed. Always confirm with the user before calling. Cannot be undone.

delete_widget

Reads a custom connection. Returns needs_key or ready. Does not fetch the URL and never returns the key. Call this after the user says they pasted the key.

get_custom_connection

Returns the full template tree, derived schema, and binding names for one template_id. Use when validation fails or you need to patch an existing layout. list_templates stays a catalog — do not dump every tree.

get_template

Returns this Glance account's live plan, quotas, usage, and capability flags. Call before promising Pro-only features (UI on Demand) or extra layouts, feeds, or automations. Do not assume ChatGPT Plus, Claude Pro, or any host plan equals Glance Pro. agent_messages_per_day applies only to in-app Glance Chat, not ChatGPT/Claude. If capabilities.ui_on_demand is true, ingest may use inline_ui (XOR with template_id) to change chrome per update. If false, always create_template + template_id. Never send both arms. family_views, family_charts, family_grid, and family_table are Pro+ layout language families. If a flag is false, do not emit that family (named views / set_view, toggle_flag + visibleFlag, chart, grid, or table). If capabilities.extra_large_widget is false, do not create or edit an extra-large widget or template. If capabilities.custom_connections is false, do not create a custom URL connection.

get_plan

Returns a widget's last ingest time, automations, ingest URL, and live layout. When uiMode is on_demand, includes inline_ui.tree (what is on the Home Screen). Never returns a write key. widget_config_id and feed_id come from create_dynamic_widget or list_widgets.

get_widget_status

Pushes live content to a Glance feed you own. This is how ChatGPT/Claude update a widget. Uses the OAuth access token — do not HTTP POST and do not send a write key. content keys must match binding names (the names inside {{ }}), not provider field IDs. XOR: template_id or inline_ui (or top-level tree), never both. inline_ui is Pro+ (call get_plan). Allowed on public widgets; subscribers see the last push. Glance-pull automations always use template_id. On-device widgets: after create_automation, ingest placeholders for every binding so the layout attaches; live Apple data overwrites on the phone. Do not tell the user you saved a layout when you used inline_ui.

ingest