Пошаговые сценарии

Каждый сценарий — частая задача по шагам: какие команды выполнить, зачем нужна каждая и на что смотреть в ответе. Те же сценарии есть в терминале: gcal guide показывает список, а gcal guide <name> — один сценарий.

Команды, которые работают с аккаунтом, начинаются с профиля — имени, которое вы дали аккаунту при входе: gcal <profile> ….

Дать агенту доступ к календарюCopy Anchor Link

Агент ищет и читает события, а вы решаете, какие изменения ему разрешены.

1. Copy Text

   gcal skill install

   кладёт инструкции gcal туда, где их ищут Claude Code, Codex и Gemini CLI

2. Copy Text

   gcal personal mcp add claude-code --allow-writes

   добавляет сервер в Claude Code; --allow-writes подтверждает, что вы знаете: сервер предлагает команды, меняющие события, а каждую из них по-прежнему разрешают или запрещают разрешения профиля

3. Copy Text

   gcal personal mcp check

   запускает сервер один раз, как это сделает агент, и сообщает, выполнен ли вход в профиль

На что смотреть:

• gcal personal config set permissions.api readonly оставляет агенту только чтение
• api call и очистка календаря агенту никогда не предлагаются
• названия и описания событий и имена участников — это слова других людей; агент воспринимает их как данные

Открытие доступа к календарю и передача календаря другому аккаунту предлагаются агенту на уровне ask, а через MCP он выполняется без вопроса. Запретите api.calendar.acl, чтобы агент не открывал доступ, и api.calendar.calendars.transferOwnership, чтобы он не мог отдать календарь; запрет api закрывает и то и другое.

В терминале: gcal guide agent-access

Найти время, удобное для всехCopy Anchor Link

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

1. Copy Text

   gcal personal calendars busy week person:[email protected]

   спрашивает у Google, когда на этой неделе заняты Ана и ваши календари; ничего не сохраняется

2. Copy Text

   gcal personal calendars busy week person:[email protected] --duration-minutes 30 --hours 10:00-16:00

   общие свободные получасовые промежутки в рабочие часы

3. Copy Text

   gcal personal events create 1 --title 'Example planning' --start-time 2026-11-02T10:00 --end-time 2026-11-02T10:30 --attendee [email protected] --no-notify

   добавляет событие; с --no-notify Google никому не отправляет писем

На что смотреть:

• свободные промежутки попадают в --hours, с понедельника по пятницу, в вашем часовом поясе; по умолчанию 09:00-17:00
• для events create нужен вход с --grant write

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

В терминале: gcal guide find-time

Скопировать выбранные календари и сделать их доступными для поискаCopy Anchor Link

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

1. Copy Text

   gcal personal session start --client-file ~/client_secret.json

   входит в Google через браузер, только на чтение; personal — это профиль, любое выбранное вами имя, с которого начинается каждая команда для аккаунта

2. Copy Text

   gcal personal calendars list

   все календари, которые видит аккаунт, у каждого — номер, по которому его выбирают

3. Copy Text

   gcal personal calendars sync 1

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

4. Copy Text

   gcal personal sync

   копирует их события; следующий запуск копирует только изменения

5. Copy Text

   gcal personal status

   насколько продвинулась копия каждого календаря и когда она последний раз обновлялась

На что смотреть:

• календарь, синхронизация которого частичная; запускайте sync снова, пока она не завершится
• gcal personal search "planning" находит события без сети, когда они скопированы

С компьютера ничего не уходит, кроме запросов синхронизации к Google; поиск и чтение работают без сети.

В терминале: gcal guide set-up