Things MCP Server

Сервер MCP для интеграции Claude Desktop с приложением Things. Позволяет создавать задачи, управлять проектами и анализировать данные прямо из диалога с ИИ-ассистентом.

Возможности

• Доступ ко всем спискам Things (Inbox, Today, Upcoming, Anytime, Someday, Logbook, Trash)
• Управление проектами и областями (Areas)
• Работа с тегами и тегированными элементами
• Расширенный поиск с фильтрацией по статусу, дате, тегу, области и типу
• Просмотр недавно созданных элементов
• Детальная информация о задачах, включая чеклисты
• Поддержка вложенных данных (проекты в областях, задачи в проектах)

Установка

Требования

• Python 3.12+
• Claude Desktop
• Things 3 (в настройках включите "Enable Things URLs" в Settings → General)

Шаги

1. Установите uv, если ещё не сделали этого:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   Перезапустите терминал.

2. Склонируйте репозиторий:

   git clone https://github.com/hald/things-mcp
   

3. Установите зависимости:

   cd things-mcp
   uv venv
   uv pip install -r pyproject.toml
   

4. Настройте Claude Desktop: Откройте файл конфигурации:

   code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

   Добавьте в секцию mcpServers:

   {
     "mcpServers": {
       "things": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
           "run",
           "things_server.py"
         ]
       }
     }
   }
   

   Укажите абсолютный путь к папке things-mcp.

5. Перезапустите Claude Desktop.

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

• "Что у меня в списке дел на сегодня?"
• "Создай задачу упаковаться в отпуск на пляж на следующую неделю, включи чеклист."
• "Оцени мои текущие задачи по матрице Эйзенхауэра."
• "Помоги провести еженедельный обзор по GTD в Things."

Советы

• Создайте проект в Claude с кастомными инструкциями, где описано, как вы организуете Things (области, проекты, теги). Укажите, какую информацию включать в описание задачи при создании.
• Подключите MCP-сервер календаря, чтобы Claude мог блокировать время под задачи или создавать дела на основе событий.

Доступные инструменты

Просмотр списков

Основные операции

• get-todos — получить задачи (опционально с фильтром по проекту)
• get-projects — все проекты
• get-areas — все области

Работа с тегами

• get-tags — все теги
• get-tagged-items — элементы с указанным тегом

Поиск

• search-todos — простой поиск по названию/заметкам
• search-advanced — расширенный поиск с фильтрами:
  • status — статус (incomplete, completed, canceled)
  • start_date — дата начала (YYYY-MM-DD)
  • deadline — крайний срок (YYYY-MM-DD)
  • tag — тег
  • area — UUID области
  • type — тип (to-do, project, heading)

По времени

• get-recent — недавние элементы. Параметр period — временной промежуток (3d, 1w, 2m, 1y)

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

• get-todos: project_uuid (опц.), include_items (по умолч. true)
• get-projects, get-areas, get-tags: include_items (по умолч. false)

Обработка ошибок

Сервер логирует и возвращает описательные сообщения при:

• неверных UUID
• отсутствии обязательных параметров
• проблемах с доступом к базе Things
• ошибках форматирования данных

Для просмотра логов MCP в Claude Desktop выполните в терминале:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Зависимости

Библиотека Things.py и URL Scheme Things.