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

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

Управляет списками и задачами в Google Tasks через REST API с помощью curl и jq. Находит просроченные дела, группирует задачи по спискам и формирует сводки.

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

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

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

Скилл обращается к Tasks v1 REST API через системные утилиты curl и jq. Агент запрашивает списки из users/@me/lists, извлекает идентификаторы и фильтрует задачи по срокам, статусу выполнения и позициям внутри списка. Поддерживается выборка дел на сегодня, поиск просроченных задач и выгрузка завершённых пунктов за последнюю неделю для отчётов.

Для выполнения запросов требуется токен авторизации в переменной $GOOGLE_TASKS_TOKEN. Без него или при коде 401 запросы работать не будут. Если токен выдан только с правами tasks.readonly, любые операции записи завершатся с ошибкой 403 insufficientPermissions — для добавления или удаления задач нужен полный скоуп tasks.

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

  • Собрать список просроченных задач со всех списков Google Tasks
  • Сформировать еженедельную сводку по выполненным делам
  • Найти все незавершённые задачи на сегодня с сортировкой по сроку
  • Получить детали конкретной задачи с прикреплёнными ссылками

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

  • Покажи все незавершённые дела из Google Tasks на сегодня
  • Собери список задач с просроченным дедлайном по всем спискам
  • Какие задачи в Google Tasks я закрыл за последние 7 дней?

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о google-tasks

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

Выполните команду npx skills add AceDataCloud/Skills --skill google-tasks -a claude-code. Файл конфигурации сохранится в ~/.claude/skills/google-tasks/SKILL.md.

Что нужно для работы скилла?

В системе должны быть установлены утилиты curl и jq, а в окружении объявлена переменная $GOOGLE_TASKS_TOKEN с действующим OAuth-токеном Google Tasks.

Почему возникает ошибка 403 при создании или изменении задачи?

Ошибка 403 insufficientPermissions означает, что токен содержит только область доступа tasks.readonly. Для изменения данных нужно переустановить коннектор с полным скоупом tasks.

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

SKILL.md · Apache-2.0
---
name: google-tasks
description: Read and manage Google Tasks task lists and individual tasks via the Tasks v1 REST API. Use when the user mentions Google Tasks, todo / pending / overdue tasks, weekly task recap, grouping todos by list, adding or completing a task, or moving / deleting tasks.
when_to_use: |
  Trigger when the user wants to inspect or manage their Google
  Tasks — list task lists, surface pending items, group by due date,
  pull details for one task, add new todos, mark items complete,
  re-order or delete tasks. The installed connector always grants
  `tasks.readonly`; the user opts in to the broader `tasks` scope
  (full read + write) at install — confirm before destructive writes.
connections: [google/tasks]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.1"
---

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

The Tasks 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
`tasks.readonly` — ask them to re-install with the read+write box
checked.

**Always start with `users/@me/lists`** to discover which task lists
the account has — the user's default plus any extras they created on
calendar.google.com or in the Tasks app.

**Before bulk creates / completions / deletes** echo the exact
titles back to the user and ask them to confirm. Don't trash a
task by guessing an id.

## Recipes

### Verify auth + list all task lists (always run first)

```sh
curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  "https://tasks.googleapis.com/tasks/v1/users/@me/lists" \
  | jq '.items[] | {id, title, updated}'
```

The default list is usually titled "我的任务" / "My Tasks" but the
**id** (a long opaque string like `MTAxMjM0NTY3OA`) is what every
subsequent `lists/{id}/tasks` call needs.

### List all unfinished tasks across every list

```sh
curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  "https://tasks.googleapis.com/tasks/v1/users/@me/lists" \
  | jq -r '.items[] | "\(.id)\t\(.title)"' | while IFS=$'\t' read LIST_ID LIST_TITLE; do
    curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
      --get "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks" \
      --data-urlencode 'showCompleted=false' \
      --data-urlencode 'maxResults=100' \
      | jq --arg list "$LIST_TITLE" '.items[]? | {list: $list, title, due, status, notes}'
  done | jq -s '. | sort_by(.due // "9999")'
```

`showCompleted=false` filters out done items at the API level. The
default `showCompleted=true&showHidden=false` returns done tasks too.

### Pending tasks in one specific list, sorted by due date

```sh
LIST_ID='MTAxMjM0NTY3OA'
curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  --get "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks" \
  --data-urlencode 'showCompleted=false' \
  --data-urlencode 'maxResults=100' \
  | jq '.items // [] | sort_by(.due // "9999") | .[] | {title, due, notes, status, position}'
```

`position` is the user's drag-to-reorder rank inside the list — useful
when the user says "what's at the top of my tasks". Tasks without a
`due` field are open-ended.

### Tasks due today

```sh
TODAY=$(date -u +%Y-%m-%d)
TOMORROW=$(date -u -d "+1 day" +%Y-%m-%d 2>/dev/null \
  || date -u -v+1d +%Y-%m-%d)
TODAY_START="${TODAY}T00:00:00.000Z"
TOMORROW_START="${TOMORROW}T00:00:00.000Z"

curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  "https://tasks.googleapis.com/tasks/v1/users/@me/lists" \
  | jq -r '.items[] | "\(.id)\t\(.title)"' | while IFS=$'\t' read LIST_ID LIST_TITLE; do
    curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
      --get "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks" \
      --data-urlencode "dueMin=$TODAY_START" \
      --data-urlencode "dueMax=$TOMORROW_START" \
      --data-urlencode 'showCompleted=false' \
      | jq --arg list "$LIST_TITLE" '.items[]? | {list: $list, title, due, notes}'
  done | jq -s
```

`dueMin` / `dueMax` are RFC 3339 timestamps. The Tasks API stores
`due` at midnight UTC, so the local-day window is approximate around
the date boundary — that's fine for "due today" semantics, mention
the caveat only if the user pushes back.

### Overdue tasks (everything still pending with a due date in the past)

```sh
NOW=$(date -u +%Y-%m-%dT%H:%M:%S.000Z)
curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  "https://tasks.googleapis.com/tasks/v1/users/@me/lists" \
  | jq -r '.items[] | "\(.id)\t\(.title)"' | while IFS=$'\t' read LIST_ID LIST_TITLE; do
    curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
      --get "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks" \
      --data-urlencode "dueMax=$NOW" \
      --data-urlencode 'showCompleted=false' \
      | jq --arg list "$LIST_TITLE" '.items[]? | {list: $list, title, due, daysOverdue: (((now * 1000) - (.due | sub("Z"; "+00:00") | fromdateiso8601 * 1000)) / 86400000 | floor)}'
  done | jq -s
```

### Recently completed tasks (this week, for a recap)

```sh
ONE_WEEK_AGO=$(date -u -d "-7 days" +%Y-%m-%dT%H:%M:%S.000Z 2>/dev/null \
  || date -u -v-7d +%Y-%m-%dT%H:%M:%S.000Z)

curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  "https://tasks.googleapis.com/tasks/v1/users/@me/lists" \
  | jq -r '.items[] | "\(.id)\t\(.title)"' | while IFS=$'\t' read LIST_ID LIST_TITLE; do
    curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
      --get "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks" \
      --data-urlencode 'showCompleted=true' \
      --data-urlencode 'showHidden=true' \
      --data-urlencode "completedMin=$ONE_WEEK_AGO" \
      | jq --arg list "$LIST_TITLE" '.items[]? | select(.status=="completed") | {list: $list, title, completed}'
  done | jq -s '. | sort_by(.completed)'
```

`completedMin` / `completedMax` mirror `dueMin`/`Max` and only apply
to tasks already moved to the "completed" state. You **must** pass
`showCompleted=true` AND `showHidden=true` to see them — Google hides
completed tasks from the default list.

### Get one task's details

```sh
LIST_ID='MTAxMjM0NTY3OA'
TASK_ID='dGFza0lkRXhhbXBsZQ'
curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks/$TASK_ID" \
  | jq '{title, due, status, notes, completed, position, links: .links}'
```

`links` exposes the user's manual hyperlinks (e.g. an attached email
or Drive doc) — render them as a list to the user when present.

### Pagination

`maxResults` caps at 100 per page. Use `nextPageToken`:

```sh
LIST_ID='MTAxMjM0NTY3OA'
PAGE_TOKEN=''
while : ; do
  RESP=$(curl -sS -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
    --get "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks" \
    --data-urlencode 'maxResults=100' \
    --data-urlencode 'showCompleted=false' \
    ${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 `tasks` scope. If the user only granted
`tasks.readonly` you'll get `403 insufficientPermissions` — surface
that and ask them to re-install with the read+write box checked.

### Add a new task

```sh
LIST_ID='MTAxMjM0NTY3OA'
curl -sS -X POST -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"title":"Draft Q2 plan","notes":"Outline + risks + asks.","due":"2026-05-15T00:00:00.000Z"}' \
  "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks" \
  | jq '{id, title, due, status}'
```

Google stores `due` as midnight UTC of the chosen day — the time of
day is ignored in the UI. To insert at the very top of the list,
add `?previous=` (no value) to the URL.

### Bulk add three tasks under user confirmation

```sh
LIST_ID='MTAxMjM0NTY3OA'
DUE='2026-05-12T00:00:00.000Z'
for T in 'Reply to Alice' 'Review PR #404' 'Send meeting recap'; do
  curl -sS -X POST -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
    -H 'Content-Type: application/json' \
    --data "{\"title\":$(jq -nr --arg t "$T" '$t'),\"due\":\"$DUE\"}" \
    "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks" \
    | jq -c '{id, title, due}'
done
```

Always list the titles you're about to create and ask for the user's
go-ahead before running this loop — there is no atomic batch endpoint.

### Mark a task complete

```sh
LIST_ID='MTAxMjM0NTY3OA'
TASK_ID='dGFza0lkRXhhbXBsZQ'
NOW=$(date -u +%Y-%m-%dT%H:%M:%S.000Z)
curl -sS -X PATCH -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data "{\"status\":\"completed\",\"completed\":\"$NOW\"}" \
  "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks/$TASK_ID" \
  | jq '{id, title, status, completed}'
```

Reverse with `{"status":"needsAction","completed":null}`.

### Edit a task's title / notes / due date

```sh
LIST_ID='MTAxMjM0NTY3OA'
TASK_ID='dGFza0lkRXhhbXBsZQ'
curl -sS -X PATCH -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"title":"Draft Q2 plan (rev2)","notes":"Cover risks + asks + budget.","due":"2026-05-20T00:00:00.000Z"}' \
  "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks/$TASK_ID" \
  | jq '{id, title, due, notes}'
```

### Delete a task

```sh
LIST_ID='MTAxMjM0NTY3OA'
TASK_ID='dGFza0lkRXhhbXBsZQ'
curl -sS -X DELETE -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks/$TASK_ID" \
  -o /dev/null -w 'HTTP %{http_code}\n'
```

`204` = success. There is no soft-delete — once gone the task is
gone. Echo the title back before deleting.

### Re-order: move a task to a position

```sh
LIST_ID='MTAxMjM0NTY3OA'
TASK_ID='dGFza0lkRXhhbXBsZQ'
PREV='dGFza0lkUHJldg'  # task id this one should appear AFTER; omit to move to top
curl -sS -X POST -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  --data '' \
  "https://tasks.googleapis.com/tasks/v1/lists/$LIST_ID/tasks/$TASK_ID/move?previous=$PREV" \
  | jq '{id, title, parent, position}'
```

Use `?parent=...` instead of `?previous=...` to nest a task under
another task as a sub-task.

### Create a brand-new task list

```sh
curl -sS -X POST -H "Authorization: Bearer $GOOGLE_TASKS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"title":"Q2 follow-ups"}' \
  "https://tasks.googleapis.com/tasks/v1/users/@me/lists" \
  | jq '{id, title}'
```

## Common error codes

| HTTP | meaning | what to tell the user |
|---|---|---|
| `401 UNAUTHENTICATED` | token expired / revoked | "Reconnect the Google Tasks connector on the Connections page." |
| `403 insufficientPermissions` | write scope missing | "This action needs the Tasks read+write scope, but only `tasks.readonly` was granted. Re-install the connector with the read+write box checked." |
| `404 notFound` | wrong list / task id | re-list with `users/@me/lists` to find the right id. |
| `429 quotaExceeded` | quota / throttling | back off ~5s, then retry once. |

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

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

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

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

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

google-tasks membrane Скилл связывает агента с Google Tasks через Membrane CLI. Помогает создавать списки дел, закрывать выполненные задачи и проверять расписание прямо из консоли. CX Codex +1 481установок gws-tasks официальный googleworkspace Скилл gws-tasks для Claude Code управляет списками и задачами Google Tasks через gws. Агент может планировать работу из терминала. CX Codex +1 47 200установок recipe-review-overdue-tasks официальный googleworkspace Скилл recipe-review-overdue-tasks для Claude Code находит просроченные задачи в Google Tasks и помогает разобрать их по срокам. Проверяет список дел на просроченные задачи. CX Codex +1 31 200установок anki-connect intellectronica Скилл anki-connect связывает ИИ-агента с десктопным приложением Anki через локальный API. Он помогает искать колоды, добавлять заметки и управлять карточками. CX Codex +1 930установок google-calendar dotneet Управляет событиями в Google Calendar и задачами в Google Tasks прямо из чата с ассистентом. Помогает планировать расписание и вести списки дел. CX Codex +1 451установок raindrop-api intellectronica Скилл raindrop-api связывает ИИ-агента с закладками Raindrop.io через REST API. Он нужен для поиска, создания, изменения и сортировки закладок. CX Codex +1 511установок skill-stocktake affaan-m Скилл skill-stocktake проверяет качество локальных и глобальных скиллов Claude Code. Находит устаревшие файлы и проводит аудит батчами через субагента. CX Codex +1 6 200установок

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

Весь набор →
tencentcloud-dns Скилл tencentcloud-dns для Claude Code управляет записями DNSPod через API Tencent Cloud: создаёт A, AAAA, CNAME, MX и TXT, ищет и удаляет записи. Меняет DNS из терминала или чата с агентом. CX Codex +1 218установок github Управляет задачами, пулл-реквестами, релизами и поиском кода на GitHub через утилиту gh. Обновляет issue и разбирает ревью прямо из чата. CX Codex +1 218установок tencentcloud-tke Скилл tencentcloud-tke для Claude Code управляет кластерами Tencent Kubernetes Engine и нагрузками через SDK и kubectl. Перезапускает деплои и масштабирует поды. CX Codex +1 217установок tencentcloud-edgeone Управляет зонами Tencent Cloud EdgeOne: очищает и прогревает CDN-кэш, работает с DNS-записями и показывает настройки WAF. Выполняет задачи после деплоя и проверяет конфигурацию. CX Codex +1 217установок tencentcloud-cls-alarm Скилл tencentcloud-cls-alarm для Claude Code управляет тревогами Tencent Cloud CLS: политиками, группами уведомлений, временными глушителями и журналом срабатываний. Настраивает и проверяет оповещения. CX Codex +1 216установок linkedin Публикует текстовые и ссылочные посты в личной ленте LinkedIn через Posts API. Перед отправкой просит подтвердить текст. CX Codex +1 215установок gitlab Скилл учит агента работать с GitLab через glab: заводить issue, смотреть merge request, гонять пайплайны и искать по коду. CX Codex +1 215установок slack Ищет сообщения в открытых каналах Slack и отправляет ответы бота после подтверждения пользователя. CX Codex +1 215установок

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

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