Сервер Model Context Protocol (MCP), который соединяет Клода и других помощников ИИ с Things 3 для управления задачами на естественном языке.

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

Записи проходят через AppleScript, а не схему URL-адресов Things, которая позволяет delete_todo, move_record/bulk_move_records, remove_tags, реальные идентификаторы возвращаются синхронно, и нет токена Things auth — компромиссом является одноразовая подсказка разрешения на автоматизацию macOS при первой записи. Оперативно он также поставляется со встроенной диагностикой doctor, настройкой клиента config --write, оптимизированными по контексту режимами реагирования для больших баз данных и 1300+ единичными тестами.

hald/things-mcp - это надежная, более легкая альтернатива на основе URL-схем - здесь также приняты несколько его идей (фильтрация проектов, отчетность об использовании тегов, упаковка [T6]). См. docs/COMPARISON.md для подробной матрицы.

Предпосылки

macOS 12+ Вещи 3 устанавливаются и открываются не реже одного раза

• uv brew install uv macOS запросит разрешение на автоматизацию для Things 3 при первом написании — это ожидаемо (AppleScript — это то, что позволяет удалять / перемещать операции, которых нет на других серверах).

##Установка

###Клод Десктоп

** Вариант А: один клик .mcpb**

Скачайте последнюю '.

Things 3 MCP Server

A Model Context Protocol (MCP) server that connects Claude and other AI assistants to Things 3 for natural language task management.

Why this server?

Writes go through AppleScript, not the Things URL scheme, which is what enables delete_todo, move_record/bulk_move_records, remove_tags, real IDs returned synchronously, and no Things auth token — the trade-off is a one-time macOS Automation permission prompt on first write. Operationally it also ships built-in doctor diagnostics, config --write client setup, context-optimized response modes for large databases, and 1300+ unit tests.

hald/things-mcp is a solid, lighter URL-scheme-based alternative — several of its ideas (Someday-project filtering, tag usage reporting, .mcpb packaging) are adopted here too. See docs/COMPARISON.md for the detailed matrix.

Prerequisites

• macOS 12+
• Things 3 installed and opened at least once
• uv (brew install uv)
• macOS will ask for Automation permission for Things 3 on the first write — that’s expected (AppleScript is what enables delete/move operations other servers lack).

Install

Claude Desktop

Option A: One-click .mcpb

Download the latest .mcpb file from the releases page and double-click it to install into Claude Desktop.

The bundle launches the server via uvx, so uv must be installed and on PATH (brew install uv). The generated config pins uv’s managed Python (--python-preference only-managed) so a stray Intel/Rosetta Python on your PATH can’t break the install; first launch may download a managed CPython.

Option B: config CLI

mcp-server-things config --client claude-desktop --write

Safely adds/updates the things entry in your Claude Desktop config (--force overwrites an existing, different entry instead of refusing).

Option C: Manual JSON

{
  "mcpServers": {
    "things": {
      "command": "uvx",
      "args": ["--python-preference", "only-managed", "--python", "3.12", "mcp-server-things"]
    }
  }
}

Claude Code

claude mcp add-json things '{"command":"uvx","args":["--python-preference","only-managed","--python","3.12","mcp-server-things"]}'
claude mcp add-json things '{"command":"uvx","args":["--python-preference","only-managed","--python","3.12","mcp-server-things"]}' -s user

mcp-server-things config --client claude-code prints these exact commands.

Any MCP client

{
  "command": "uvx",