К основному содержанию
скилл CX Codex

google-calendar · acedatacloud — скилл для Claude Code: что делает и как установить

Скилл google-calendar для Claude Code просматривает расписание, ищет свободные окна и планирует встречи в Google Календаре через Calendar v3 REST API. Управляет событиями без перехода в браузер.

Apache-2.0 222 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill google-calendar -a claude-code
Открыть на GitHub

Что делает google-calendar

Скилл взаимодействует с API Google Календаря v3 через утилиты curl и jq. Агент запрашивает список доступных календарей, считывает часовой пояс учётной записи и выгружает встречи на день или неделю с разворачиванием повторяющихся событий через флаг singleEvents=true.

Для выполнения запросов требуется действующий OAuth-токен в переменной окружения $GOOGLE_CALENDAR_TOKEN. Без полного скоупа calendar любая попытка создать или отменить событие завершится ошибкой 403 insufficientPermissions. Для упрощённого добавления событий и форматирования повестки скилл также умеет вызывать опциональный CLI @googleworkspace/cli (gws).

Какие задачи решает

  • собрать повестку встреч на сегодня с учётом часового пояса
  • проверить свободные интервалы времени в расписании
  • создать или отменить встречу с отправкой писем участникам
  • найти пересечения и конфликты в календарях

Примеры запросов агенту

  • Покажи моё расписание встреч на сегодня
  • Проверь свободные окна в календаре на завтра после обеда
  • Создай встречу Standup на завтра в 10:00 и добавь [email protected]

Как установить google-calendar

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill google-calendar -a claude-code

2Вручную: положить файлы

~/.claude/skills/google-calendar/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/google-calendar/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о google-calendar

Как установить google-calendar в Claude Code?

Выполните команду npx skills add AceDataCloud/Skills --skill google-calendar -a claude-code.

Что нужно настроить перед запуском?

Задайте OAuth-токен в переменной $GOOGLE_CALENDAR_TOKEN. Для создания и изменения событий токен должен содержать скоуп calendar, а не только calendar.readonly.

Обязательно ли устанавливать утилиту gws?

Нет, пакет @googleworkspace/cli опционален. Скилл способен выполнять чтение и манипуляции событиями через базовые рецепты curl и jq.

Исходный текст

SKILL.md · Apache-2.0
---
name: google-calendar
description: Read and manage Google Calendar events / agenda / free-busy / invitations via the Calendar v3 REST API. Use when the user mentions Google Calendar events, today's agenda, this week's meetings, finding conflicts, listing invitations, checking free time, or scheduling / rescheduling / cancelling a meeting.
when_to_use: |
  Trigger when the user wants to read or manage events on their
  Google Calendar — list / search / inspect events, build today's
  or this week's agenda, check free / busy windows, pull invite
  details, or have the AI create / update / cancel events on their
  behalf and email invites to attendees. The installed connector
  always grants `calendar.readonly`; the user opts in to the
  broader `calendar` scope (full read + write) at install — confirm
  before destructive writes.
connections: [google/calendar]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.2"
---

Drive Google Calendar via `curl + jq`. The user's OAuth bearer token
is in `$GOOGLE_CALENDAR_TOKEN`; every call needs it as
`Authorization: Bearer $GOOGLE_CALENDAR_TOKEN`. At minimum the token
carries `calendar.readonly` plus the identity scopes
(`openid email profile`); if the user opted in to write at install
time it also carries the broader `calendar` scope (read + write).

The Calendar API returns standard JSON; failures surface as
`{"error": {"code": 401|403|..., "message": "..."}}` — show that
error verbatim. `401` means the token expired (re-install). `403
insufficientPermissions` on a write means the user only granted
`calendar.readonly` — ask them to re-install the connector with the
read+write box checked.

**Always start with `users/me/calendarList`** to learn which calendars
the account can see (the user's primary plus any subscribed / shared
ones), AND with `users/me/settings/timezone` so you render times in
the user's local zone instead of UTC.

**Before any destructive write** (creating, moving, or cancelling an
event that has attendees) show the exact event details and ask the
user to confirm. When attendees are involved, also confirm whether
they want Google to email the attendees — that's controlled by the
`sendUpdates` query parameter.

## Optional: Google Workspace CLI (`gws`) for agenda + create

[`gws`](https://github.com/googleworkspace/cli) is Google's official CLI
(not officially supported — community-maintained on the `googleworkspace`
org). It dynamically builds its command surface from Google's Discovery
Document, exits non-zero on API errors, and ships hand-crafted helper
commands (prefixed `+`) for time-aware workflows.

**Use `gws` for two specific cases:**

- `+agenda` reads the user's account timezone from `Settings.timezone`
  (cached for 24 h) and renders today's events in that zone, so you don't
  have to fetch the timezone yourself before formatting times.
- `+insert` shapes the create-event JSON for you (attendees, sendUpdates,
  reminders) so a one-line invocation produces a well-formed request.

For everything else (events.list / patch / move / delete, freebusy,
calendarList) the curl recipes below are equivalent and shorter — stay
on those.

### Install

```sh
npm install -g @googleworkspace/cli   # or: brew install googleworkspace-cli
# Pre-built binaries also at https://github.com/googleworkspace/cli/releases
gws --version
```

### Auth

`gws` reads its OAuth bearer token from the `GOOGLE_WORKSPACE_CLI_TOKEN`
environment variable. The Calendar token used in this skill is in
`$GOOGLE_CALENDAR_TOKEN`, so re-export it once at the top of every shell
block that calls `gws`:

```sh
export GOOGLE_WORKSPACE_CLI_TOKEN="$GOOGLE_CALENDAR_TOKEN"
```

### Agenda + create

```sh
# Today on the primary calendar, in the account's own timezone
gws calendar +agenda

# Today / week, with explicit overrides
gws calendar +agenda --today --tz America/New_York
gws calendar +agenda --range week

# Create an event (auto-shapes attendees + sendUpdates JSON)
gws calendar +insert --calendar primary \
  --json '{
    "summary":"Standup",
    "start":{"dateTime":"2026-05-06T10:00:00-04:00"},
    "end":  {"dateTime":"2026-05-06T10:30:00-04:00"},
    "attendees":[{"email":"[email protected]"}]
  }' \
  --params '{"sendUpdates":"all"}'
```

Both helpers exit non-zero with a structured JSON error on stderr if
Google rejects the request — surface that verbatim. `+insert` against
attendees requires the broader `calendar` scope; on `403
insufficientPermissions` ask the user to re-install with read+write
checked.

## Recipes

### Verify auth + discover calendars (always run first)

```sh
# Account confirmation + calendars the user can read
curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/users/me/calendarList" \
  | jq '.items[] | {id, summary, primary, accessRole, timeZone}'

# User's preferred display zone (use this when formatting times)
curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/users/me/settings/timezone" \
  | jq -r .value
```

The `id` of each calendar (`primary`, or an email-shaped id like
`[email protected]`) is what subsequent
`calendars/{id}/events` calls take.

### Today's agenda on the primary calendar

```sh
TZ=$(curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/users/me/settings/timezone" | jq -r .value)
TODAY=$(TZ=$TZ date +%Y-%m-%d)
START="${TODAY}T00:00:00Z"
END="${TODAY}T23:59:59Z"

curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  --get "https://www.googleapis.com/calendar/v3/calendars/primary/events" \
  --data-urlencode "timeMin=$START" \
  --data-urlencode "timeMax=$END" \
  --data-urlencode 'singleEvents=true' \
  --data-urlencode 'orderBy=startTime' \
  --data-urlencode "timeZone=$TZ" \
  | jq '.items[] | {summary, start: (.start.dateTime // .start.date), end: (.end.dateTime // .end.date), location, attendees: [.attendees[]?.email], hangout: .hangoutLink, status, htmlLink}'
```

`singleEvents=true` flattens recurring meetings into individual
instances — almost always what you want for an agenda. Without it,
you'd get the recurrence rule once and have to expand it client-side.

### This week's meetings (Mon–Sun)

```sh
TZ=$(curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/users/me/settings/timezone" | jq -r .value)
# Bash date math: Monday-of-this-week
MON=$(TZ=$TZ date -d "$(TZ=$TZ date +%Y-%m-%d) -$(($(TZ=$TZ date +%u) - 1)) days" +%Y-%m-%d 2>/dev/null \
  || TZ=$TZ date -v-mondayw +%Y-%m-%d)  # macOS fallback
SUN=$(TZ=$TZ date -d "$MON +6 days" +%Y-%m-%d 2>/dev/null \
  || TZ=$TZ date -v+6d -j -f %Y-%m-%d "$MON" +%Y-%m-%d)

curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  --get "https://www.googleapis.com/calendar/v3/calendars/primary/events" \
  --data-urlencode "timeMin=${MON}T00:00:00Z" \
  --data-urlencode "timeMax=${SUN}T23:59:59Z" \
  --data-urlencode 'singleEvents=true' \
  --data-urlencode 'orderBy=startTime' \
  | jq -r '.items[] | "\(.start.dateTime // .start.date)\t\(.summary)\t\((.attendees // []) | length) attendees"'
```

### Search events by query

```sh
Q='quarterly review'
curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  --get "https://www.googleapis.com/calendar/v3/calendars/primary/events" \
  --data-urlencode "q=$Q" \
  --data-urlencode 'singleEvents=true' \
  --data-urlencode 'maxResults=20' \
  | jq '.items[] | {start: .start.dateTime, summary, htmlLink}'
```

`q` matches against summary, description, location, attendee emails,
and creator/organizer.

### Get one event's full details (incl. attendees, location, link)

```sh
EVENT_ID='abc123def4567890ghijklmnop'
curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/calendars/primary/events/$EVENT_ID" \
  | jq '{summary, start, end, location, description, attendees, organizer, hangoutLink, conferenceData}'
```

### Free / busy across multiple calendars (next 7 days)

```sh
TZ=$(curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/users/me/settings/timezone" | jq -r .value)
NOW=$(TZ=$TZ date -u +%Y-%m-%dT%H:%M:%SZ)
NEXT_WEEK=$(TZ=$TZ date -u -d "+7 days" +%Y-%m-%dT%H:%M:%SZ 2>/dev/null \
  || TZ=$TZ date -u -v+7d +%Y-%m-%dT%H:%M:%SZ)

cat > /tmp/freebusy.json <<JSON
{
  "timeMin": "$NOW",
  "timeMax": "$NEXT_WEEK",
  "timeZone": "$TZ",
  "items": [
    {"id": "primary"},
    {"id": "[email protected]"}
  ]
}
JSON

curl -sS -X POST -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  -H 'Content-Type: application/json' \
  --data @/tmp/freebusy.json \
  "https://www.googleapis.com/calendar/v3/freeBusy" \
  | jq '.calendars'
```

Each calendar's response is `{"busy": [{"start": "...", "end": "..."}]}`
— gaps between are free.

### List events on a non-primary calendar

```sh
CAL_ID='[email protected]'
# URL-encode the @ in the path
CAL_ENCODED=$(printf %s "$CAL_ID" | jq -sRr @uri)
curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  --get "https://www.googleapis.com/calendar/v3/calendars/$CAL_ENCODED/events" \
  --data-urlencode 'singleEvents=true' \
  --data-urlencode 'orderBy=startTime' \
  --data-urlencode 'maxResults=20' \
  | jq '.items[] | {start: .start.dateTime, summary}'
```

### Pagination

```sh
PAGE_TOKEN=''
while : ; do
  RESP=$(curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
    --get "https://www.googleapis.com/calendar/v3/calendars/primary/events" \
    --data-urlencode 'singleEvents=true' \
    --data-urlencode 'orderBy=startTime' \
    --data-urlencode 'maxResults=250' \
    ${PAGE_TOKEN:+--data-urlencode "pageToken=$PAGE_TOKEN"})
  echo "$RESP" | jq -c '.items[]?'
  PAGE_TOKEN=$(echo "$RESP" | jq -r '.nextPageToken // empty')
  [ -z "$PAGE_TOKEN" ] && break
done
```

## Write recipes

These all need the broader `calendar` scope. If the user only granted
`calendar.readonly` you'll get `403 insufficientPermissions` —
surface that and ask them to re-install with the read+write box
checked. **Always echo the event summary, time and attendee list
back to the user before creating or cancelling anything.**

### Create a single event (with optional attendees + Google Meet link)

```sh
TZ=$(curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/users/me/settings/timezone" | jq -r .value)

cat > /tmp/_cal_event.json <<JSON
{
  "summary": "Sync — Q2 OKR review",
  "location": "Online",
  "description": "Drafted by AceDataCloud.",
  "start": {"dateTime": "2026-05-12T10:00:00", "timeZone": "$TZ"},
  "end":   {"dateTime": "2026-05-12T10:30:00", "timeZone": "$TZ"},
  "attendees": [
    {"email": "[email protected]"},
    {"email": "[email protected]"}
  ],
  "reminders": {"useDefault": true},
  "conferenceData": {
    "createRequest": {
      "requestId": "meet-$(date +%s)",
      "conferenceSolutionKey": {"type": "hangoutsMeet"}
    }
  }
}
JSON

# sendUpdates: 'all' = email all attendees; 'externalOnly' = only non-org; 'none' = silent
curl -sS -X POST -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  -H 'Content-Type: application/json' \
  --data @/tmp/_cal_event.json \
  "https://www.googleapis.com/calendar/v3/calendars/primary/events?conferenceDataVersion=1&sendUpdates=all" \
  | jq '{id, htmlLink, hangoutLink, summary, start, end, attendees}'
```

Drop the `conferenceData` block if the user didn't ask for a Meet
link — it'll fall back to a plain event.

### Create a recurring event

```sh
TZ=$(curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/users/me/settings/timezone" | jq -r .value)
cat > /tmp/_cal_recur.json <<JSON
{
  "summary": "Weekly 1:1",
  "start": {"dateTime": "2026-05-12T15:00:00", "timeZone": "$TZ"},
  "end":   {"dateTime": "2026-05-12T15:30:00", "timeZone": "$TZ"},
  "recurrence": ["RRULE:FREQ=WEEKLY;BYDAY=TU;COUNT=12"]
}
JSON
curl -sS -X POST -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  -H 'Content-Type: application/json' \
  --data @/tmp/_cal_recur.json \
  "https://www.googleapis.com/calendar/v3/calendars/primary/events" \
  | jq '{id, recurrence, summary}'
```

RRULE follows RFC 5545. Common patterns: `FREQ=DAILY`, `FREQ=WEEKLY;BYDAY=MO,WE,FR`,
`FREQ=MONTHLY;BYMONTHDAY=15`. Add `UNTIL=20261231T235959Z` or `COUNT=12`
for a hard stop.

### Update an existing event (PATCH — partial update)

```sh
EVENT_ID='abc123def4567890ghijklmnop'
curl -sS -X PATCH -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"location":"Conference Room 4","description":"Now in-person."}' \
  "https://www.googleapis.com/calendar/v3/calendars/primary/events/$EVENT_ID?sendUpdates=all" \
  | jq '{id, summary, location, description}'
```

`PATCH` only changes the fields you send; `PUT` replaces the entire
event payload. Prefer `PATCH`.

### Reschedule an event

```sh
EVENT_ID='abc123def4567890ghijklmnop'
TZ=$(curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/users/me/settings/timezone" | jq -r .value)
cat > /tmp/_cal_resched.json <<JSON
{
  "start": {"dateTime": "2026-05-12T14:00:00", "timeZone": "$TZ"},
  "end":   {"dateTime": "2026-05-12T14:30:00", "timeZone": "$TZ"}
}
JSON
curl -sS -X PATCH -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  -H 'Content-Type: application/json' \
  --data @/tmp/_cal_resched.json \
  "https://www.googleapis.com/calendar/v3/calendars/primary/events/$EVENT_ID?sendUpdates=all" \
  | jq '{id, summary, start, end}'
```

### Add or change attendees

Google requires you to send the **complete** attendee list when
patching attendees — fetch the current list, mutate, send back:

```sh
EVENT_ID='abc123def4567890ghijklmnop'
CURRENT=$(curl -sS -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/calendars/primary/events/$EVENT_ID?fields=attendees" \
  | jq '.attendees // []')
NEW=$(echo "$CURRENT" | jq '. + [{"email":"[email protected]"}]')
curl -sS -X PATCH -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  -H 'Content-Type: application/json' \
  --data "{\"attendees\": $NEW}" \
  "https://www.googleapis.com/calendar/v3/calendars/primary/events/$EVENT_ID?sendUpdates=all" \
  | jq '{id, attendees}'
```

### Cancel / delete an event

```sh
EVENT_ID='abc123def4567890ghijklmnop'
curl -sS -X DELETE -H "Authorization: Bearer $GOOGLE_CALENDAR_TOKEN" \
  "https://www.googleapis.com/calendar/v3/calendars/primary/events/$EVENT_ID?sendUpdates=all" \
  -o /dev/null -w 'HTTP %{http_code}\n'
```

`204` = success. To cancel one occurrence of a recurring event, fetch
the instance with `events.instances` first, then `DELETE` the
specific instance id (it has a longer `EVENT_ID_YYYYMMDDTHHMMSSZ`
shape).

## Common error codes

| HTTP | meaning | what to tell the user |
|---|---|---|
| `401 UNAUTHENTICATED` | token expired / revoked | "Reconnect the Google Calendar connector on the Connections page." |
| `403 insufficientPermissions` | write scope missing | "This action needs the Calendar read+write scope, but only `calendar.readonly` was granted. Re-install the connector with the read+write box checked." |
| `403 forbidden` | calendar id not visible to this account | check `calendarList` first; if it's a shared calendar, the owner needs to share it. |
| `404 notFound` | wrong event / calendar id | double-check the id and try `calendarList` to confirm the calendar exists. |
| `409 conflict` | recurring event id collision | append a UUID to your `requestId` and retry. |
| `429 quotaExceeded` | quota / throttling | back off ~5s, then retry once. |

Never log or echo `$GOOGLE_CALENDAR_TOKEN` — treat it as a secret.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →

Сначала — google-calendar от других авторов.

google-calendar sanjay3290 Скилл google-calendar для Claude Code управляет Google Calendar: показывает события, ищет свободное время и меняет встречи. Подключается по запросам о расписании или приглашениях. CX Codex +1 547установок google-calendar membrane Подключает Google Calendar через Membrane CLI. Агент читает расписание, создаёт и удаляет события прямо из чата. CX Codex +1 337установок google-calendar dotneet Управляет событиями в Google Calendar и задачами в Google Tasks прямо из чата с ассистентом. Помогает планировать расписание и вести списки дел. CX Codex +1 451установок gws-calendar-insert официальный googleworkspace Скилл gws-calendar-insert для Claude Code, Cursor и других AI-редакторов, который позволяет агенту создавать события в Google Calendar прямо из кода. CX Codex +1 50 200установок gws-calendar-agenda davila7 Команда gws-calendar-agenda для Claude Code, которая выводит предстоящие события из Google Calendar через CLI gws. Запускается с флагами --today, --week, --days или --calendar для фильтрации по дням и календарям. CX Codex +1 80установок gws-calendar davila7 Команда gws-calendar для управления календарями, событиями и правами доступа в Google Calendar прямо из Claude Code через утилиту gws. CX Codex +1 76установок Google Calendar googlecalendar MCP-сервер Google Calendar подключает Google Календарь к ассистенту через удалённый эндпоинт. Помогает назначать встречи, искать свободные слоты для участников и отвечать на приглашения прямо в чате. CX Codex +1 15 718установок google-calendar-automation davepoon Скилл google-calendar-automation управляет событиями Google Calendar, ищет свободные интервалы и работает с участниками через Rube MCP. CX Codex +1 142установок google odyssey4me Подключает Google Workspace через CLI-инструмент gog. CX Codex +1 844установок

Из того же набора67

Весь набор →
ai-chat Скилл ai-chat подключает шлюз AceDataCloud к агенту для вызова более 50 моделей LLM через единый API. Запускается при запросах к Claude, GPT, Gemini, DeepSeek или Kimi с сохранением контекста и стримингом. CX Codex +1 230установок zhihu Скилл подключает Zhihu к агенту: ищет посты и весь веб, показывает горячие темы, отдаёт статистику ваших статей и ответов. CX Codex +1 229установок short-url Скилл short-url для Claude Code создаёт короткие ссылки через AceDataCloud API. Готовит длинный URL к передаче или публикации. CX Codex +1 228установок face-transform Скилл face-transform для Claude Code, Codex, Cursor и других платформ, который подключает семь API AceDataCloud для работы с лицами: поиск ключевых точек, ретушь портретов, изменение возраста и пола, замена лиц. CX Codex +1 228установок blogger Работает с Blogger API v3: публикует записи, читает блоги и посты, обновляет публикации. Управляет блогом из Claude Code. CX Codex +1 221установок tencentcloud-cls Скилл ищет и анализирует логи Tencent Cloud CLS: помогает находить ошибки API, трассировать запросы и запускать CQL/SQL-запросы. CX Codex +1 221установок youtube Ищет видео на YouTube, читает данные канала и помогает загружать ролики через YouTube Data API v3. Проверяет статистику и комментарии своих видео. CX Codex +1 221установок google-drive Скилл google-drive управляет конкретными файлами Google Диска через REST API v3, читает документы, экспортирует таблицы и загружает отчёты. CX Codex +1 219установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой