Things Safe MCP

Неофициальный MCP-сервер для Things 3, использующий только те методы интеграции, которые Cultured Code документирует как безопасные:

• AppleScript для чтения и обычного редактирования задач.

• URL-схема Things для правки контрольных списков.

Он не читает и не записывает базу данных Things, служебные файлы приложения или учётные данные Things Cloud. Он работает только на macOS и требует Things 3.

Установка

Установите uv, затем зарегистрируйте сервер в своём MCP-клиенте. Для Codex:

codex mcp add things -- uvx --from git+https://github.com/jasongibby/things-safe-mcp things-safe-mcp

Для другого MCP-клиента с поддержкой stdio используйте:

{
  "mcpServers": {
    "things": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jasongibby/things-safe-mcp",
        "things-safe-mcp"
      ]
    }
  }
}

Запустите Things один раз перед первым запросом. macOS запросит разрешение для вашего MCP-хоста на автоматизацию Things.

Токен контрольного списка

Только правка контрольных списков требует авторизационный токен Things URL. В Things откройте Настройки → Общие → Включить Things URL → Управление, создайте токен и передайте его серверу как THINGS_AUTH_TOKEN через безопасную конфигурацию окружения вашего MCP-клиента. Не добавляйте его в коммиты и не делитесь им ни с кем.

Все остальные операции работают без токена.

Инструменты

• Читать списки «Входящие», «Сегодня», «Предстоящие», «Любое время», «Когда-нибудь», проекты, задачи проектов и задачи, отмеченные тегами напрямую.

• Искать по названиям задач и заметкам.

• Создавать задачи.

• Изменять названия, заметки, теги, статус, расписание и привязку к проекту. Передайте пустой ID проекта, чтобы отсоединить задачу.

• Заменять, добавлять в конец или в начало пункты контрольного списка.

Безопасность и конфиденциальность

Cultured Code относит AppleScript и URL-схему Things к безопасным способам подключения. Этот сервер передаёт пользовательский ввод как аргументы процесса, а не подставляет его в исходный код AppleScript.

Ваш MCP-клиент и AI-провайдер могут видеть данные задач, возвращаемые сервером. Ознакомьтесь с их политиками конфиденциальности перед использованием. Этот проект не связан с Cultured Code и не получил его одобрения.

• Сторонние AI-инструменты и Things

• Команды AppleScript Things

• URL-схема Things

Разработка

uv sync
uv run python -m unittest discover -s tests -v

Тесты имитируют все внешние процессы и никогда не обращаются к Things.

Лицензия

MIT