Операции с календарём работают с запланированными встречами (в API — occurrence), теми же, что показывают календарь приложения и страница подготовки к встрече. Операции с сериями управляют сериями сессий и их расписаниями. Большинство этих операций по умолчанию включены в разделе «Доступ по MCP». Ассистенты могут планировать и готовить встречи, но запись всегда начинается в приложении. Каждая операция также принимает необязательный workspaceId. Общие правила описаны в разделе Как читать этот справочник.

Операция	Тип	Инструмент	По умолчанию	Группа
`calendar.upcoming`	Чтение	`talkbar_read`	Вкл.	`metadata`
`calendar.get`	Чтение	`talkbar_read`	Вкл.	`metadata`
`calendar.prep`	Чтение	`talkbar_read`	Вкл.	`content`
`calendar.actionable`	Чтение	`talkbar_read`	Вкл.	`metadata`
`calendar.schedule`	Изменение	`talkbar_change`	Вкл.	`scheduling`
`calendar.prepare`	Изменение	`talkbar_change`	Вкл.	`scheduling`
`calendar.prep.edit`	Изменение	`talkbar_change`	Вкл.	`scheduling`
`calendar.move`	Изменение	`talkbar_change`	Вкл.	`scheduling`
`calendar.snooze`	Изменение	`talkbar_change`	Вкл.	`scheduling`
`calendar.cancel`	Изменение	`talkbar_delete`	Вкл.	`scheduling`
`calendar.skip`	Изменение	`talkbar_delete`	Вкл.	`scheduling`
`calendar.start`	Изменение	`talkbar_change`	Вкл.	`scheduling`
`calendar.tick`	Изменение	`talkbar_change`	Выкл.	`scheduling`
`series.list`	Чтение	`talkbar_read`	Вкл.	`metadata`
`series.get`	Чтение	`talkbar_read`	Вкл.	`metadata`
`series.kinds.list`	Чтение	`talkbar_read`	Вкл.	`metadata`
`series.schedule.get`	Чтение	`talkbar_read`	Вкл.	`metadata`
`series.create`	Изменение	`talkbar_change`	Вкл.	`scheduling`
`series.update`	Изменение	`talkbar_change`	Вкл.	`scheduling`
`series.archive`	Изменение	`talkbar_delete`	Вкл.	`scheduling`
`series.sessions.assign`	Изменение	`talkbar_change`	Вкл.	`scheduling`
`series.schedule.set`	Изменение	`talkbar_change`	Вкл.	`scheduling`

Статусы встреч

Встреча может иметь статус planned, started, completed, missed, skipped, cancelled или unscheduled. Время указывается в миллисекундах эпохи Unix.

`calendar.upcoming`

Постранично выводит отдельные встречи и встречи серий в заданном интервале времени, начиная с ближайших.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata

Аргументы

startAtMsrequired

integer

Начало интервала, мс эпохи Unix. Выводятся встречи, которые пересекаются с интервалом.

endAtMsrequired

integer

Конец интервала, мс эпохи Unix. Не может быть раньше startAtMs.

includeArchived

boolean

Показывать и запланированные встречи серий из архива, которые календарь приложения скрывает. По умолчанию false.

statuses

string[]

Какие встречи выводить. Значения: planned, started, completed, missed, skipped, cancelled. Если поле пустое или не указано — запланированные, начатые, завершённые и несостоявшиеся.

limit

integer

Сколько вернуть: от 1 до 500. По умолчанию 100.

offset

integer

nextOffset из предыдущей страницы.

Возвращает: {occurrences, nextOffset}. Строки — это встречи в том виде, в каком их возвращает calendar.get, только вместо самих настроек запуска указано prepared: true/false (прочитать настройки можно через calendar.get или calendar.prep).

{"tool": "calendar.upcoming", "args": {"startAtMs": 1761955200000, "endAtMs": 1762560000000}}

`calendar.get`

Читает одну запланированную встречу.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata

Аргументы

occurrenceIdrequired

string

Запланированная встреча из calendar.upcoming.

Возвращает: встречу: occurrenceId, seriesId, scheduleId, plannedStartAtMs, originalStartAtMs, durationMinutes, timezone, status, sessionId, title, preparedSetupJson (сохранённые настройки запуска в виде строки JSON), reminderOffsetsMinutes, startMode, autoStartCountdownSeconds, moved, wasScheduled (false для встречи, подготовленной без запланированного времени), sessionTitle (название связанной сессии, когда оно появится), quiet (в приложении выбрано «Не напоминать»: встреча видна в календаре, но не напоминает о себе и не начинается автоматически), createdAt, updatedAt.

{"tool": "calendar.get", "args": {"occurrenceId": "occ_1"}}

`calendar.prep`

Читает то, что показывает для встречи страница подготовки в приложении: заметки к встрече, карточки и документы, с которыми она начнётся, задачи, которые она забирает с других встреч, и предыдущую сессию серии.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики content

Аргументы

occurrenceIdrequired

string

Запланированная встреча из calendar.upcoming.

Возвращает: occurrenceId, title, status, plannedStartAtMs, durationMinutes, seriesId, sessionId, prepared, preparable, projectId, sessionTemplateId, notes ([{noteId, title, preview, updatedAt}]), cards ([{memoryId, title, type, status}]), documents, actionItems ({carried, carriedOverflow, added, skipped, suggested}) и previousSession ({sessionId, title, startedAtMs, private} или null).

Заметку к встрече можно прочитать через notes.get, а итоги предыдущей сессии — через sessions.get. Заметки к встрече пишутся в приложении.

{"tool": "calendar.prep", "args": {"occurrenceId": "occ_1"}}

`calendar.actionable`

Выводит напоминания о встречах, которые ждут действия «Начать», «Отложить» или «Пропустить».

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata

Аргументы: только workspaceId.

Возвращает: массив напоминаний [{jobId, occurrenceId, offsetMinutes, remindAtMs, status, snoozedUntilMs, createdAt, updatedAt}], начиная с ближайших. Саму встречу можно прочитать через calendar.get.

`calendar.schedule`

Планирует отдельную встречу или встречу серии. Запись при этом никогда не начинается.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

occurrenceIdrequired

string

Идентификатор новой встречи, который вы выбираете сами. Должен быть новым.

plannedStartAtMsrequired

integer

Время начала, мс эпохи Unix. Прошедшее время допускается, чтобы встречу можно было внести уже после того, как она состоялась.

durationMinutesrequired

integer

Длительность в минутах, не меньше 1.

timezonerequired

string

Часовой пояс IANA, например America/New_York.

seriesId

string

Добавить встречу в эту серию. Серия должна быть активной (не в архиве).

title

string

Название встречи, от 1 до 200 символов.

reminderOffsetsMinutes

integer[]

За сколько минут до начала напомнить. До 6 значений, каждое от 0 до 10 080; повторы убираются. По умолчанию [10].

startMode

string

prompt (спросить перед началом) или automatic (начать после обратного отсчёта в приложении). По умолчанию prompt.

autoStartCountdownSeconds

integer

Длительность обратного отсчёта перед автоматическим началом, в секундах: от 5 до 300. По умолчанию 60.

preparedSetup

object

Настройки запуска, которые сохраняет подготовка к встрече в приложении. Для неуказанных полей остаются значения приложения по умолчанию. Неизвестные поля отклоняются.

source: mic, system или both; micDeviceId.
sessionTemplateId, projectId, topicIds, memoryIds (карточки знаний), documentIds.
summariesEnabled, summaryLanguage (auto или код языка итогов), summaryLength (short, standard или detailed), summaryModel ({providerId, modelId}).
participants: [{name, contactId}]; у каждого участника должно быть name.
memoryMode: normal, session_only, manual_only или sensitive. speakerMode: solo, duo, small или large. privateSession.
origin: {name, url}.
actionItemIds, skippedActionItemIds: только для чтения; встреча сохраняет свои списки (изменить их можно через calendar.prep.edit).

Шаблоны, проекты, люди, карточки и документы должны быть в этом рабочем пространстве, а карточки — одобрены.

Создаёт напоминания так же, как приложение. Повторяющийся occurrenceId отклоняется с кодом failed.

{"tool": "calendar.schedule", "args": {"occurrenceId": "occ_weekly_sync_1107", "plannedStartAtMs": 1762531200000, "durationMinutes": 30, "timezone": "America/New_York", "title": "Weekly sync"}}

`calendar.prepare`

Изменяет название, настройки запуска, напоминания или режим запуска встречи. Неуказанные поля сохраняют свои значения.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

occurrenceIdrequired

string

Запланированная встреча из calendar.upcoming.

title

string | null

Новое название от 1 до 200 символов или null, чтобы очистить его.

reminderOffsetsMinutes

integer[]

За сколько минут до начала напомнить. До 6 значений, каждое от 0 до 10 080.

startMode

string

prompt или automatic.

autoStartCountdownSeconds

integer

Длительность обратного отсчёта перед автоматическим началом, в секундах: от 5 до 300.

preparedSetup

object

Настройки запуска, как в calendar.schedule. Если поле указано, оно целиком заменяет сохранённые настройки: прочитайте их через calendar.get, измените и отправьте обратно полностью. null очищает их.

Работает с запланированными, несостоявшимися и незапланированными встречами; для остальных запрос отклоняется с кодом failed. Подготовка несостоявшейся встречи снова делает её запланированной.
Встреча, время начала которой прошло, всегда получает режим prompt.

{"tool": "calendar.prepare", "args": {"occurrenceId": "occ_1", "title": "Northwind kickoff", "reminderOffsetsMinutes": [15, 5]}}

`calendar.prep.edit`

Добавляет или убирает карточки знаний, документы и задачи с других встреч, с которыми начнётся встреча, или пропускает перенесённую задачу — так же, как страница подготовки в приложении. Применяются либо все изменения, либо ни одного.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

occurrenceIdrequired

string

Запланированная встреча из calendar.upcoming.

editsrequired

object[]

Изменения, от 1 до 50. Каждое имеет вид {kind, id, add}:

kind: memory (карточка знаний), document, actionItem (задача, напоминание или вопрос с другой встречи) или skippedActionItem (перенесённая задача, которую не нужно брать на эту встречу).
id: идентификатор элемента.
add: true добавляет (или пропускает); false убирает (или возвращает пропущенный элемент).

Возвращает: подготовку к встрече: occurrenceId, prepared, preparable, sessionId, projectId, memoryIds, documentIds, maxMemoryCount, maxDocumentCount, sessionTemplateId, hasContent, draftCount и actionItemCount. Полные списки показывает calendar.prep.

Неверный идентификатор или тип, пропуск элемента, который не был перенесён, или элемент, который одновременно добавлен и пропущен, отклоняются с кодом invalid_arguments, и ничего не меняется.
Для встречи, которая уже началась, была отменена или пропущена, запрос отклоняется с кодом failed.

{"tool": "calendar.prep.edit", "args": {"occurrenceId": "occ_1", "edits": [{"kind": "memory", "id": "mem_321", "add": true}, {"kind": "document", "id": "doc_8", "add": true}]}}

`calendar.move`

Переносит одну встречу и обновляет её напоминания и автоматическое начало. Остальные встречи серии не меняются.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

occurrenceIdrequired

string

Запланированная встреча из calendar.upcoming.

plannedStartAtMsrequired

integer

Новое время начала, мс эпохи Unix. Должно быть в будущем.

Работает с запланированными, несостоявшимися и незапланированными встречами.

{"tool": "calendar.move", "args": {"occurrenceId": "occ_1", "plannedStartAtMs": 1762617600000}}

`calendar.snooze`

Откладывает напоминание о запланированной встрече и отменяет обратный отсчёт автоматического начала, если он идёт. Встреча остаётся запланированной.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

occurrenceIdrequired

string

Запланированная встреча из calendar.upcoming.

snoozedUntilMsrequired

integer

Когда напомнить снова, мс эпохи Unix. Должно быть в будущем.

Отложить можно только запланированную встречу.
После откладывания режим запуска встречи становится prompt.

`calendar.cancel`

Отменяет одну запланированную встречу вместе с её напоминаниями и автоматическим началом. Серия в архив не перемещается.

Изменение · выполняется через talkbar_delete · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

occurrenceIdrequired

string

Запланированная встреча из calendar.upcoming.

Отменить можно только запланированную встречу; иначе ответ failed называет её текущий статус.
Выполняется через talkbar_delete: требует вашего подтверждения, если ваше ИИ-приложение умеет его запрашивать; запросы приложений, которые не умеют, отклоняются, если не включён параметр Разрешить удаление без подтверждения.

`calendar.skip`

Пропускает одну запланированную встречу и отменяет её напоминания и обратный отсчёт. Серия и другие её встречи не меняются.

Изменение · выполняется через talkbar_delete · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

occurrenceIdrequired

string

Запланированная встреча из calendar.upcoming.

Пропустить можно только запланированную встречу; иначе ответ failed называет её текущий статус.
Выполняется через talkbar_delete: требует вашего подтверждения, если ваше ИИ-приложение умеет его запрашивать; запросы приложений, которые не умеют, отклоняются, если не включён параметр Разрешить удаление без подтверждения.

`calendar.start`

Проверяет, можно ли начать встречу отсюда. MCP и CLI никогда не ведут запись, поэтому операция ничего не меняет и только объясняет, почему встречу начать нельзя.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

occurrenceIdrequired

string

Запланированная встреча из calendar.upcoming.

Возвращает: {intent: null, unavailableReason}. unavailableReason — captureHostUnavailable для запланированной встречи и notPlanned для остальных.

Операция не проверяет, может ли приложение начать встречу прямо сейчас. Начинайте запись в приложении.

`calendar.tick`

Выполняет один проход планировщика встреч: создаёт предстоящие встречи по расписаниям серий, готовит для них напоминания и отмечает как несостоявшиеся прошедшие встречи без записи. Уведомлений не отправляет и ничего не записывает.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Выкл. · группа политики scheduling

Аргументы

horizonEndMsrequired

integer

Создавать встречи до этого момента, мс эпохи Unix. Не может быть раньше nowMs.

nowMsrequired

integer

Момент, для которого выполняется проход, мс эпохи Unix.

limit

integer

Наибольшее число подошедших по времени элементов за один проход: от 1 до 100. По умолчанию 32.

Возвращает: массив обратных отсчётов автоматического начала, время которых подошло: [{kind, intent, occurrence}].

Приложение выполняет эту операцию само; в разделе «Доступ по MCP» она по умолчанию выключена, и ассистенту она редко нужна.

`series.list`

Выводит серии сессий со счётчиками.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata

Аргументы

includeArchived

boolean

Показывать и серии из архива.

Возвращает: массив серий (в том виде, в каком их возвращает series.get) с полями sessionCount, lastSessionStartedAtMs, nextPlannedAtMs, projectName, customKind и schedule ({enabled, scheduleKind, rrule, localDate, localTime, timezone, durationMinutes} или null).

{"tool": "series.list", "args": {}}

`series.get`

Читает одну серию сессий.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata

Аргументы

seriesIdrequired

string

Серия из series.list.

Возвращает: серию: seriesId, workspaceId, name, kind, customKindId, description, projectId, anchorContactId, templateId, startTemplateJson, archivedAtMs, createdAt, updatedAt.

`series.kinds.list`

Выводит встроенные типы серий с рекомендуемыми шаблонами, собственные типы серий рабочего пространства и значки, которые может использовать тип.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata

Аргументы: только workspaceId.

Возвращает: {builtin: [{key, suggestedTemplateId}], custom: [{kindId, name, icon, createdAt, updatedAt}], icons}.

`series.schedule.get`

Читает расписание серии, если оно есть.

Чтение · выполняется через talkbar_read · переключатель MCP по умолчанию Вкл. · группа политики metadata

Аргументы

seriesIdrequired

string

Серия из series.list.

Возвращает: расписание или null: scheduleId, seriesId, enabled, scheduleKind, timezone, localDate, localTime, durationMinutes, title, rrule, reminderOffsetsMinutes, startMode, autoStartCountdownSeconds, effectiveFromOriginalStartMs (заполняется, если расписание действует начиная с определённой встречи), createdAt, updatedAt.

`series.create`

Создаёт серию сессий, которую можно связать с проектом, человеком и шаблоном.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

seriesIdrequired

string

Идентификатор новой серии, который вы выбираете сами. Должен быть новым.

namerequired

string

Название серии, от 1 до 120 символов.

kindrequired

string

Тип серии: oneOnOne, standup, teamMeeting, inPersonMeeting, clientMeeting, phoneCall, interview, hiringInterview, userResearch, salesCall, customerCheckIn, investorCall, legalConsultation, boardMeeting, leadershipSync, coaching, mentoring, workshop, training, brainstorm, retro, presentation, presentationPractice, productLaunch, lecture, class, course, educationalTalk, tutorial, webinar, panelDiscussion, podcast, videoWatching, voiceJournal, speakingPractice или custom.

customKindId

string

При kind: "custom" — один из собственных типов серий рабочего пространства (series.kinds.list).

description

string

Описание.

projectId

string

Проект, к которому относится серия.

anchorContactId

string

Главный человек, с которым проходит серия.

templateId

string

Шаблон, с которым начинаются её сессии.

Сессии остаются отдельными, пока вы не добавите их в серию через series.sessions.assign. Повторяющийся seriesId отклоняется с кодом failed.

{"tool": "series.create", "args": {"seriesId": "ser_dana_1on1", "name": "1:1 with Dana", "kind": "oneOnOne", "anchorContactId": "ct_77"}}

`series.update`

Изменяет данные серии. Поля, допускающие null, очищаются значением null.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

seriesIdrequired

string

Серия из series.list.

name

string

Новое название, от 1 до 120 символов.

kind

string

Тип серии, как в series.create.

customKindId

string | null

Один из собственных типов серий рабочего пространства, для kind: "custom". null очищает его.

description

string | null

Описание. null очищает его.

projectId

string | null

Проект, к которому относится серия. null очищает его.

anchorContactId

string | null

Главный человек, с которым проходит серия. null очищает его.

templateId

string | null

Шаблон, с которым начинаются её сессии. null очищает его.

Укажите хотя бы одно поле. Сессии серии не меняются.

`series.archive`

Перемещает серию в архив или восстанавливает её. Её сессии и история сохраняются.

Изменение · выполняется через talkbar_delete · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

seriesIdrequired

string

Серия из series.list.

archivedrequired

boolean

true перемещает в архив, false восстанавливает.

Архивация скрывает запланированные встречи серии (из календаря приложения, а также из calendar.upcoming, если не задан includeArchived) и останавливает их напоминания и автоматическое начало. Несостоявшимися они не отмечаются.
Восстановление возвращает будущие встречи, а те, время которых прошло, пока серия была в архиве, получают статус skipped.
Если серия уже в архиве, повторная архивация сохраняет дату первой.
Выполняется через talkbar_delete: требует вашего подтверждения, если ваше ИИ-приложение умеет его запрашивать; запросы приложений, которые не умеют, отклоняются, если не включён параметр Разрешить удаление без подтверждения.

`series.sessions.assign`

Добавляет сессии в серию или убирает их из серии.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

sessionIdsrequired

string[]

Сессии, которые нужно переместить, хотя бы одна. Сессия, указанная дважды, учитывается один раз.

seriesIdrequired

string | null

Серия или null, чтобы убрать сессии из их серии. Обязательное поле.

Возвращает: {changed} — сколько сессий изменилось.

В серию из архива нельзя добавлять сессии (failed). Неизвестные сессии и сессии в корзине возвращают not_found, каждая названа отдельно.
Меняется только принадлежность к серии; содержимое сессий, проекты и файлы не затрагиваются.

{"tool": "series.sessions.assign", "args": {"sessionIds": ["ses_123", "ses_124"], "seriesId": "ser_dana_1on1"}}

`series.schedule.set`

Создаёт или заменяет разовое или повторяющееся расписание серии и создаёт её предстоящие встречи.

Изменение · выполняется через talkbar_change · переключатель MCP по умолчанию Вкл. · группа политики scheduling

Аргументы

seriesIdrequired

string

Серия из series.list.

scheduleKindrequired

string

one_time или recurring.

timezonerequired

string

Часовой пояс IANA, например Europe/London.

localDaterequired

string

Первая (или единственная) дата в формате YYYY-MM-DD.

localTimerequired

string

Время начала в формате HH:MM.

durationMinutesrequired

integer

Длительность в минутах, не меньше 1.

scheduleId

string

У серии одно расписание. Не указывайте это поле (идентификатор создаётся при первом сохранении) или передайте идентификатор существующего расписания; другой идентификатор отклоняется.

title

string

Название для встреч. Может быть пустым.

rrule

string

Правило повторения: обязательно для recurring и недопустимо для one_time. Поддерживаются FREQ со значениями DAILY, WEEKLY или MONTHLY, а также INTERVAL, BYDAY, BYMONTHDAY, COUNT и UNTIL, например FREQ=WEEKLY;BYDAY=TU.

reminderOffsetsMinutes

integer[]

За сколько минут до начала напомнить. До 6 значений, каждое от 0 до 10 080; повторы убираются. По умолчанию [10].

startMode

string

prompt (спросить перед началом) или automatic (начать после обратного отсчёта в приложении). По умолчанию prompt.

autoStartCountdownSeconds

integer

Длительность обратного отсчёта перед автоматическим началом, в секундах: от 5 до 300. По умолчанию 60.

effectiveFromOccurrenceId

string

Изменить расписание начиная с этой встречи («Этой и следующим»); более ранние встречи сохраняют прежнее расписание.

horizonEndMs

integer

Создавать встречи до этого момента, мс эпохи Unix. По умолчанию — 90 дней от текущего момента.

Возвращает: расписание в том виде, в каком его возвращает series.schedule.get, включая его scheduleId.

Для серии в архиве запрос отклоняется с кодом failed.

{"tool": "series.schedule.set", "args": {"seriesId": "ser_dana_1on1", "scheduleKind": "recurring", "timezone": "America/New_York", "localDate": "2026-11-03", "localTime": "10:00", "durationMinutes": 30, "rrule": "FREQ=WEEKLY;BYDAY=TU"}}

См. также

Задачи

Операции MCP и CLI, чтобы показывать, читать, создавать, изменять, завершать и убирать задачи, напоминания, вопросы и решения.

Чаты и документы

Операции MCP и CLI для чатов «Спросить TalkBar» и документов: список, чтение текста, переименование, закрепление, проекты, корзина и восстановление.

Календарь и серии