MCP-сервер TickTick — полная интеграция TickTick для Claude

License: MIT Version Python Tools Glama

28 инструментов. Полный CRUD. Умные запросы. Фильтры по нескольким условиям. Пакетные операции. Поддержка GTD. Совместимость с Dida365.

Подключите Claude к своей учетной записи TickTick и управляйте всей системой задач с помощью естественного общения — создавайте задачи, ищите по проектам, проверяйте просроченные дела, создавайте элементы пачками и оставайтесь организованными, не открывая приложение.

«Что просрочено?» --> Мгновенно показывает все пропущенные сроки по всем проектам.

Почему именно этот сервер?

Функция	Этот сервер	Официальный MCP TickTick	jacepark12
Инструменты	28	22	~20
Фильтр по нескольким условиям	Да (приоритет + тег + дата + проект)	Да	Нет
Перемещение задачи между проектами	Да	Да	Нет
Массовое завершение	Да (до 20)	Да (до 20)	Нет
Пакетное обновление	Да	Да	Нет
Просмотр завершенных задач	Да	Да	Нет
Поиск по проектам	Полнотекстовый поиск	Да	Да
Подзадачи	Да	Нет	Нет
Режим фокуса GTD	Да (высокий приоритет + срок + просрочено)	Нет	Частично
Поддержка Dida365	Да (настраиваемый базовый URL)	Нет	Да
Асинхронность (httpx)	Да	Н/Д	Нет (синхронные запросы)
Валидация Pydantic	Да (типизированные входные данные)	Н/Д	Нет
Аннотации MCP	Да (readOnly, подсказки об удалении)	Н/Д	Нет
Self-hosted / open source	Да	Нет (хостинг-сервис)	Да
Конфиденциальность	100% локально, только ваши токены	Через серверы TickTick	100% локально

Related MCP server: mcp-server-asana

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

Предварительные требования

Учетная запись TickTick
Python 3.10+
Claude Code или Claude Desktop

Шаг 1 — Клонирование и установка

git clone https://github.com/Salen-Project/ticktick-mcp
cd ticktick-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

Шаг 2 — Регистрация приложения разработчика TickTick

Перейдите на developer.ticktick.com
Нажмите New App и введите любое имя
Установите OAuth Redirect URL на: http://localhost:8080/callback
Скопируйте Client ID и Client Secret

Шаг 3 — Аутентификация

TICKTICK_CLIENT_ID=your_id TICKTICK_CLIENT_SECRET=your_secret .venv/bin/python3 setup_auth.py

Это откроет браузер для авторизации приложения. Нажмите Allow — токены будут сохранены в ~/.ticktick_mcp/tokens.json и будут обновляться автоматически.

Шаг 4 — Регистрация в Claude Code

claude mcp add ticktick \
  -e TICKTICK_CLIENT_ID=your_id \
  -e TICKTICK_CLIENT_SECRET=your_secret \
  -- /path/to/ticktick-mcp/.venv/bin/python3 /path/to/ticktick-mcp/server.py

Для Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "ticktick": {
      "type": "stdio",
      "command": "/path/to/ticktick-mcp/.venv/bin/python3",
      "args": ["/path/to/ticktick-mcp/server.py"],
      "env": {
        "TICKTICK_CLIENT_ID": "your_id",
        "TICKTICK_CLIENT_SECRET": "your_secret"
      }
    }
  }
}

Шаг 5 — Добавление навыка продуктивности (опционально)

mkdir -p ~/.claude/skills/ticktick
cp skills/ticktick/SKILL.md ~/.claude/skills/ticktick/

Поддержка Dida365

Для Dida365 (китайская версия TickTick) установите следующие переменные окружения:

TICKTICK_BASE_URL=https://api.dida365.com/open/v1
TICKTICK_TOKEN_URL=https://dida365.com/oauth/token

Примеры использования

Вы говорите	Что происходит
«Напомни позвонить стоматологу в пятницу»	Задача создана с датой выполнения
«Добавь 'проверить отчет за 1 квартал' в Работу, высокий приоритет»	Задача в проекте «Работа», приоритет 5
«Что просрочено?»	Показывает все просроченные задачи по всем проектам
«На чем мне сосредоточиться?»	Режим фокуса GTD: высокий приоритет + срок сегодня + просрочено
«Найди что-нибудь про 'бюджет'»	Полнотекстовый поиск по всем проектам
«Покажи все задачи с высоким приоритетом»	Фильтрация по приоритету=5 по всем проектам
«Что нужно сделать на этой неделе?»	Задачи со сроком в ближайшие 7 дней
«Создай задачи: купить молоко, позвонить Джону, сдать отчет»	Пакетное создание 3 задач
«Создай проект под названием 'Планирование отпуска'»	Создан новый проект
«Добавь подзадачу 'Купить солнцезащитный крем' к задаче об отпуске»	Создана подзадача
«Я закончил задачу со стоматологом»	Задача помечена как завершенная
«Удали старый проект Sprint»	Проект и все задачи удалены

Справочник инструментов MCP

Проекты (5 инструментов)

Инструмент	Описание
`ticktick_list_projects`	Список всех проектов с ID, названиями, цветами
`ticktick_get_project`	Получить детали конкретного проекта
`ticktick_get_project_with_tasks`	Получить детали проекта + все незавершенные задачи за один вызов
`ticktick_create_project`	Создать новый проект (название, цвет, режим просмотра)
`ticktick_update_project`	Обновить название, цвет или режим просмотра проекта
`ticktick_delete_project`	Безвозвратно удалить проект

Задачи — Базовый CRUD (7 инструментов)

Инструмент	Описание
`ticktick_list_tasks`	Список всех задач в конкретном проекте
`ticktick_create_task`	Создать задачу (название, срок, приоритет, проект, теги)
`ticktick_get_task`	Получить полные детали конкретной задачи
`ticktick_update_task`	Обновить название, содержание, даты или приоритет
`ticktick_complete_task`	Пометить задачу как завершенную
`ticktick_delete_task`	Безвозвратно удалить задачу
`ticktick_create_subtask`	Создать подзадачу для родительской задачи

Задачи — Умные запросы (7 инструментов)

Инструмент	Описание
`ticktick_get_all_tasks`	Получить все задачи по всем активным проектам
`ticktick_search_tasks`	Полнотекстовый поиск по названиям, содержанию, подзадачам
`ticktick_get_tasks_by_priority`	Фильтр по приоритету (Нет/Низкий/Средний/Высокий)
`ticktick_get_tasks_due_today`	Задачи со сроком сегодня по всем проектам
`ticktick_get_overdue_tasks`	Все просроченные задачи по всем проектам
`ticktick_get_tasks_due_this_week`	Задачи со сроком в ближайшие 7 дней
`ticktick_get_tasks_due_in_days`	Задачи со сроком ровно через N дней

Задачи — Пакетные операции и продуктивность (5 инструментов)

Инструмент	Описание
`ticktick_batch_create_tasks`	Создать несколько задач одновременно
`ticktick_batch_update_tasks`	Обновить несколько задач одновременно
`ticktick_complete_tasks_bulk`	Пометить до 20 задач как завершенные одновременно
`ticktick_move_task`	Переместить задачу из одного проекта в другой
`ticktick_get_focus_tasks`	Режим фокуса GTD: высокий приоритет + срок сегодня + просрочено

Задачи — Расширенные фильтры (2 инструмента)

Инструмент	Описание
`ticktick_filter_tasks`	Фильтр по нескольким условиям: приоритет + тег + диапазон дат + проект + статус
`ticktick_get_completed_tasks`	Просмотр завершенных задач в проекте

Пользователь (1 инструмент)

Инструмент	Описание
`ticktick_get_user_preferences`	Получить настройки пользователя (часовой пояс, начало недели и т.д.)

Архитектура

server.py              # 20 MCP tools, async httpx, Pydantic validation
setup_auth.py          # One-time OAuth 2.0 setup (browser-based)
~/.ticktick_mcp/       # Token storage (auto-refreshed)
skills/ticktick/       # Claude skill for natural task language

Выбор архитектуры:

Асинхронность везде — httpx.AsyncClient для неблокирующих вызовов API
Модели ввода Pydantic — Типобезопасные, валидированные входные данные с понятными сообщениями об ошибках
Аннотации MCP — readOnlyHint, destructiveHint для более безопасного использования инструментов
Автоматическое обновление токенов — Токены обновляются прозрачно с буфером в 60 секунд

Устранение неполадок

«Given client ID does not match» — Перепроверьте ваш Client ID на developer.ticktick.com.

Порт 8080 уже используется — lsof -ti:8080 | xargs kill -9, затем повторите попытку.

Токены истекли — Запустите setup_auth.py снова, чтобы получить свежие токены.

Claude не видит инструменты — Запустите claude mcp list для проверки регистрации.

Вклад в проект

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

git clone https://github.com/Salen-Project/ticktick-mcp
cd ticktick-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
# Make your changes to server.py
# Test: python3 -c "from server import mcp; print(len(mcp._tool_manager._tools), 'tools')"

Ссылки

Лицензия

MIT (c) Salen-Project

ticktick-mcp