TickTick API Skill

TickTick API Skill — это интеграция с API популярного менеджера задач TickTick через управляемую OAuth-аутентификацию. С помощью этого навыка AI-агент может работать с задачами, проектами и списками дел напрямую.

Навык предназначен для сценариев, где требуется создавать, обновлять, завершать или организовывать задачи в TickTick. Для работы с другими сторонними сервисами рекомендуется использовать отдельный навык API Gateway.

Что делает этот навык

TickTick API Skill предоставляет полный доступ к возможностям TickTick через API. Он позволяет:

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

Все операции выполняются через прокси-шлюз Maton, который автоматически добавляет OAuth-токен к каждому запросу. :

Когда использовать

Используйте этот навык, если пользователю нужно:

• управлять списком задач
• добавлять напоминания и дедлайны
• отслеживать незавершённые задачи
• структурировать проекты и рабочие процессы
• автоматизировать управление задачами через AI-агента

Требования

Для работы навыка необходимо:

• наличие сетевого доступа
• аккаунт в Maton
• действительный API-ключ (MATON_API_KEY)
• настроенное OAuth-подключение к TickTick

Аутентификация выполняется через заголовок:

Authorization: Bearer $MATON_API_KEY

Быстрый старт

Пример запроса для получения списка проектов:

import urllib.request, os, json

req = urllib.request.Request('https://gateway.maton.ai/ticktick/open/v1/project')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')

print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Базовый URL для всех запросов:

https://gateway.maton.ai/ticktick/{native-api-path}

Шлюз автоматически перенаправляет запросы к официальному API TickTick и добавляет необходимые токены авторизации. :

Управление подключениями

OAuth-подключения к TickTick управляются через интерфейс Maton. Перед использованием необходимо авторизовать доступ к аккаунту TickTick через соответствующий flow.

Установка

clawhub install ticktick-api-skill

Если CLI не установлен:

npm i -g clawhub

Итог

TickTick API Skill превращает AI-агента в полноценный инструмент управления задачами. Благодаря интеграции через Maton и управляемой OAuth-аутентификации, настройка упрощается до одного API-ключа, а взаимодействие с TickTick становится полностью автоматизированным.