Things3 MCP

MCP сервер, который обеспечивает полную интеграцию с Things3 на macOS, позволяя AI-ассистентам управлять задачами, проектами, областями и тегами через 25 специализированных инструментов с автоматическим исправлением ошибок и созданием тегов.

Установка

NPX (Рекомендуется)

npx things3-mcp@latest

Глобальная установка через NPM

npm install -g things3-mcp

Из исходного кода

git clone https://github.com/urbanogardun/things3-mcp.git
cd things3-mcp
npm install
npm run build

Конфигурация

Claude Desktop (NPX)

{
  "mcpServers": {
    "things3": {
      "command": "npx",
      "args": ["things3-mcp@latest"],
      "env": {
        "THINGS3_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

Claude Desktop (Глобальная установка)

{
  "mcpServers": {
    "things3": {
      "command": "things3-mcp",
      "env": {
        "THINGS3_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

Claude Desktop (Локально)

{
  "mcpServers": {
    "things3": {
      "command": "node",
      "args": ["/absolute/path/to/things3-mcp/dist/index.js"]
    }
  }
}

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

Инструмент	Описание
`todos_list`	Список задач с гибкими опциями фильтрации (входящие, сегодня, предстоящие и т.д.)
`todos_get`	Получение подробной информации о конкретной задаче
`todos_create`	Создание новой задачи с полной поддержкой свойств и автоматическим созданием тегов
`todos_update`	Обновление свойств существующей задачи с автоматическим созданием тегов
`todos_complete`	Отметка одной или нескольких задач как выполненных
`todos_uncomplete`	Отметка одной или нескольких задач как невыполненных
`todos_delete`	Окончательное удаление одной или нескольких задач
`projects_list`	Список проектов с опциональной фильтрацией по области
`projects_get`	Получение подробной информации о проекте
`projects_create`	Создание нового проекта с автоматическим созданием тегов
`projects_update`	Обновление свойств проекта с автоматическим созданием тегов
`projects_complete`	Отметка проекта как завершенного
`projects_delete`	Полное удаление проектов из Things3
`areas_list`	Список всех областей
`areas_create`	Создание новой области

Возможности

Полная интеграция с Things3 с 25 инструментами, покрывающими все аспекты
Управление задачами: создание, чтение, обновление, удаление, завершение и отмена завершения задач
Управление проектами и областями: полная поддержка жизненного цикла проекта с организацией областей и удалением
Система тегов: поддержка иерархических тегов с созданием, удалением и массовыми операциями с тегами
Массовые операции: эффективное перемещение или обновление нескольких элементов одновременно
Автоматическое создание тегов: теги создаются автоматически при упоминании в операциях с задачами/проектами
Исправление ошибок: автоматическое исправление распространенных проблем (конфликты дат, отсутствующие заголовки)
Поиск в журнале: поиск завершенных элементов с фильтрацией по диапазону дат
Оптимизированная производительность: пулинг соединений и оптимизация AppleScript

Переменные окружения

Обязательные

THINGS3_AUTH_TOKEN - Токен авторизации для операций обновления (изменение, завершение, удаление). Находится в настройках Things3 → Общие → Включить Things URLs → Управлять

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

Создай новый проект для редизайна сайта с задачами для планирования, дизайна и реализации

Покажи мне все мои задачи на сегодня

Создай задачу для подготовки презентации с заметками и запланируй её на следующую неделю

Завершить все задачи с тегом 'срочно'

Переместить все элементы из входящих в рабочий проект

Ресурсы

GitHub Repository

Примечания

Требует macOS с установленным приложением Things3 и включенным доступом AppleScript. Имеет ограничения с элементами чек-листов (использует URL-схемы в качестве обходного решения) и восстановлением удаленных элементов. Поддерживает автоматическое исправление ошибок для конфликтов дат и отсутствующих заголовков.

Installation

Description