ticktick-sdk

ticktick-sdk — MCP-сервер сообщества (автор — dev-mirzabicer). SDK на Python и сервер для TickTick: задачи, проекты, теги и привычки. Ставится через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
dev-mirzabicer
Лицензия
MIT
Транспорт
stdio
Авторизация
oauth
ОС
Не указана
Языки
python

Уровень риска: high

Хранит пароль и токен TickTick, создаёт, меняет и удаляет задачи, проекты, теги и привычки пакетами до 100 штук.

Настройка клиентов

claude-code
{
    "code": "claude mcp add ticktick \\\n  -e TICKTICK_CLIENT_ID=your_client_id \\\n  -e TICKTICK_CLIENT_SECRET=your_client_secret \\\n  -e TICKTICK_ACCESS_TOKEN=your_access_token \\\n  -e TICKTICK_USERNAME=your_email \\\n  -e TICKTICK_PASSWORD=your_password \\\n  -- ticktick-sdk",
    "lang": "bash",
    "notes": "Токен из ticktick-sdk auth",
    "verified": "docs"
}

Что умеет

ticktick-sdk — асинхронный Python SDK для TickTick со встроенным MCP-сервером: через него Claude и другие ИИ-ассистенты управляют вашими задачами, проектами, тегами и привычками. Поддерживается и китайская версия сервиса Dida365 (滴答清单).

У TickTick два API: официальный V1 с OAuth2 ограничен базовыми операциями, а теги, папки, привычки, фокус-сессии и подзадачи доступны только через неофициальный веб-API V2 с входом по сессии. Библиотека объединяет оба и сама выбирает, куда отправить каждую операцию. Поэтому для работы нужны и токен OAuth2, и логин с паролем от TickTick.

MCP-сервер даёт 43 инструмента; все изменяющие операции принимают списки от 1 до 100 элементов:

  • Задачи — создание, просмотр, список по статусу (активные, выполненные, отменённые, удалённые), обновление, выполнение, удаление в корзину, перенос между проектами, подзадачи, поиск по тексту, закрепление.
  • Проекты и папки — список, создание, изменение и удаление проектов, создание, переименование и удаление папок.
  • Канбан — колонки досок: создание, изменение, удаление, назначение задач в колонки.
  • Теги — иерархические теги с цветами, переименование, удаление и слияние.
  • Привычки — список, разделы утро, день и вечер, создание, изменение, архивирование, удаление, отметки выполнения, в том числе задним числом, история отметок и серии.
  • Пользователь и аналитика — профиль, статус аккаунта, статистика продуктивности, данные фокус-сессий и «помидоров».

Ответы выдаются в Markdown для людей и в JSON для программ. Флаги --enabledModules и --enabledTools позволяют оставить только нужные инструменты и сэкономить контекст модели.

Кому подойдёт

  • Пользователям TickTick и Dida365, которые хотят вести задачи и привычки голосом ассистента.
  • Любителям продуктивности, отслеживающим серии привычек и статистику.
  • Python-разработчикам, которым нужен типизированный асинхронный клиент TickTick.

Похожие серверы — в категории продуктивность.

Установка

Нужны Python 3.11+ и аккаунт TickTick (бесплатный или Pro). Установите пакет: pip install ticktick-sdk. Зарегистрируйте приложение на портале разработчиков TickTick с адресом перенаправления http://127.0.0.1:8080/callback и сохраните Client ID и Client Secret. Затем получите токен командой ticktick-sdk auth с переменными TICKTICK_CLIENT_ID и TICKTICK_CLIENT_SECRET — откроется браузер для авторизации; на сервере без браузера добавьте --manual. Для Dida365 запускайте сервер с --host dida365.com.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add ticktick \
  -e TICKTICK_CLIENT_ID=your_client_id \
  -e TICKTICK_CLIENT_SECRET=your_client_secret \
  -e TICKTICK_ACCESS_TOKEN=your_access_token \
  -e TICKTICK_USERNAME=your_email \
  -e TICKTICK_PASSWORD=your_password \
  -- ticktick-sdk

Конфиг Claude Desktop лежит в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS и %APPDATA%\Claude\claude_desktop_config.json в Windows. Для других клиентов укажите команду ticktick-sdk и те же переменные окружения.

Проверка

В Claude Code выполните claude mcp list или /mcp, затем спросите: «Какие задачи у меня на сегодня?»

Примеры задач

Создай задачу позвонить Ивану завтра в 14:00 и покажи мои задачи с высоким приоритетом.
Отметь привычку «Медитация» за сегодня и скажи, какая у меня серия по «Зарядке».

Риски

  • Пароль и токены. Сервер хранит в окружении пароль от TickTick, токен OAuth2 и секрет приложения — не публикуйте конфиг.
  • Изменения в аккаунте. Создаёт, меняет и удаляет задачи, проекты, папки, теги и привычки, причём пакетами до 100 штук за вызов. Удалённые задачи попадают в корзину, а проекты, теги и папки удаляются насовсем.
  • Неофициальный API. Часть функций работает через недокументированный веб-API V2, который может измениться без предупреждения.

Частые вопросы

Зачем серверу пароль, если есть токен?

Официальный API не даёт доступа к тегам, привычкам и фокусу; для них используется веб-API с входом по логину и паролю.

Работает ли с Dida365?

Да, запустите сервер с флагом --host dida365.com.

Можно ли включить только часть инструментов?

Да, через --enabledModules или --enabledTools.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

AutoClip

Нарезка длинных видео на короткие клипы с обложками и субтитрами.

Риск: medium Лицензия: MIT ★ 10 310

NotFair

Доступ к Google, Meta, X, LinkedIn, Reddit, TikTok, GSC, GA4 и WordPress через OAuth.

Риск: medium Лицензия: MIT ★ 4 143

obsei

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

Риск: medium Лицензия: Apache-2.0 ★ 1 452

Источники