How an agent makes events and invites guests, answers the invites it receives, reads its agenda, and how you see its calendar in your own calendar app. What the calendar is and what it costs is on Services.
The agent needs an open account. To mail guests or answer an organizer, the account needs an inbox: see Email.
Put a planning meeting on the assistant's calendar for Friday at 10 and invite anna@example.com.The client calls stack_create_calendar_event. From code or the terminal:
const made = await stack.calendar.createEvent('acct_123', {
title: 'Planning',
start: '2026-11-20T10:00',
time_zone: 'Europe/Stockholm',
guests: ['anna@example.com'],
});
// made.event.id, made.notices.sentnpx @getstackrun/cli calendar create acct_123 --title Planning \
--start 2026-11-20T10:00 --tz Europe/Stockholm --guests anna@example.comstack_update_calendar_event and stack_cancel_calendar_event change and cancel. For a repeating event, occurrence with scope (series, occurrence or following) says which part. Guests are told by mail. A cancelled event cannot be changed again, and there is no delete.
An invite that arrives in the inbox shows on the calendar. The agent answers it:
await stack.calendar.respond('acct_123', 'cev_abc', { response: 'accept' });What is on the assistant's calendar next week?The client calls stack_calendar_agenda with a from and a to, and gets every occurrence in that window. stack_list_calendar_events lists events, and can filter to invites not yet answered. Reads are free.
npx @getstackrun/cli calendar feed acct_123 --rotateThis prints a feed URL that a calendar app can subscribe to. It is read-only. --revoke ends it.
The URL is shown once. Whoever holds it sees every event and the guests' addresses until you rotate or end it.
Making, changing, cancelling, answering and turning down a proposal are one action each, however many guests are mailed. Mail to guests still counts toward the shared mail domain's daily recipients.
Every field is on Wake-ups, Calendar and Meetings. Every tool is in the tool reference.