# Пошаговые сценарии (/ru/docs/gcal/scenarios)

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

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

## Дать агенту доступ к календарю [#дать-агенту-доступ-к-календарю]

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

1. ```sh
   gcal skill install
   ```

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

2. ```sh
   gcal personal mcp add claude-code --allow-writes
   ```

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

3. ```sh
   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`

<a id="find-time" />

<a id="find-a-time-that-suits-everyone" />

## Найти время, удобное для всех [#найти-время-удобное-для-всех]

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

1. ```sh
   gcal personal calendars busy week person:ana@example.com
   ```

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

2. ```sh
   gcal personal calendars busy week person:ana@example.com --duration-minutes 30 --hours 10:00-16:00
   ```

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

3. ```sh
   gcal personal events create 1 --title 'Example planning' --start-time 2026-11-02T10:00 --end-time 2026-11-02T10:30 --attendee ana@example.com --no-notify
   ```

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

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

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

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

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

## Скопировать выбранные календари и сделать их доступными для поиска [#скопировать-выбранные-календари-и-сделать-их-доступными-для-поиска]

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

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

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

2. ```sh
   gcal personal calendars list
   ```

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

3. ```sh
   gcal personal calendars sync 1
   ```

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

4. ```sh
   gcal personal sync
   ```

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

5. ```sh
   gcal personal status
   ```

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

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

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

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

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