Этот сервер Model Context Protocol (MCP) позволяет использовать Claude Desktop для взаимодействия с данными управления задачами в Things 3 из Cultured Code. Вы можете попросить Claude создавать задачи, анализировать проекты, помогать с приоритетами и многое другое.

Этот сервер использует библиотеку Things.py и схему URL Things.

Поддержите проект

Если этот проект вам полезен, рассмотрите возможность поддержки его разработки:

Особенности

• Доступ ко всем основным спискам Things (Входящие, Сегодня, Предстоящие и др.)
• Управление проектами и территориями
• Операции с тегами
• Расширенные возможности поиска
• Последние материалы
• Подробная информация о товарах, включая контрольные списки
• Поддержка вложенных данных (проекты внутри областей, задачи внутри проектов)
• Фильтрация проектов Someday: задачи в проектах Someday автоматически исключаются из просмотров Today, Coming и Anytime, что соответствует поведению UI Things

Установка

Требования

• macOS (Things 3 доступна только для Mac)
• Приложение Things 3 с включённым «Enable Things URLs» (Настройки → Общие)
• MCP-клиент, например Claude Desktop или Claude Code
• менеджер пакетов uv Python: brew install uv

Установка через uvx (любой MCP-клиент)

Things MCP публикуется на PyPI и может запускаться напрямую с помощью uvx:

Things MCP Server

This Model Context Protocol (MCP) server lets you use ChatGPT, Codex, Claude Desktop, and other MCP clients to interact with your task management data in Things 3 from Cultured Code. You can ask your assistant to create tasks, analyze projects, help manage priorities, and more.

This server leverages the Things.py library and the Things URL Scheme.

Support the Project

If you find this project helpful, consider supporting its development:

Features

• Access to all major Things lists (Inbox, Today, Upcoming, etc.)
• Project and area management
• Tag operations
• Advanced search capabilities
• Recent items
• Detailed item information including checklists
• Support for nested data (projects within areas, todos within projects)
• Someday project filtering: tasks in Someday projects are automatically excluded from Today, Upcoming, and Anytime views, matching Things UI behavior

Installation

Prerequisites

• macOS (Things 3 is Mac-only)
• Things 3 app with “Enable Things URLs” turned on (Settings → General)
• An MCP client, such as the ChatGPT desktop app, Codex, Claude Desktop, or Claude Code
• uv Python package manager: brew install uv

Install via uvx (Any MCP Client)

Things MCP is published on PyPI and can be run directly with uvx:

uvx things-mcp

Configure your MCP client to use uvx with things-mcp as the argument.

Claude Desktop

Option 1: One-Click Install (Recommended)

1. Download the latest file from the releases page
2. Double-click the .mcpb file
3. Done!

Option 2: Manual Config

1. Go to Claude → Settings → Developer → Edit Config
2. Add the Things server:

{
  "mcpServers": {
    "things": {
      "command": "uvx",
      "args": ["things-mcp"]
    }
  }
}

3. Save and restart Claude Desktop

Claude Code

claude mcp add-json things '{"command":"uvx","args":["things-mcp"]}'

To make it available globally (across all projects), add -s user:

claude mcp add-json -s user things '{"command":"uvx","args":["things-mcp"]}'

ChatGPT Desktop and Codex

The ChatGPT desktop app, Codex CLI, and Codex IDE extension share the same local MCP configuration. The quickest way to add Things MCP is with the Codex CLI:

codex mcp add things -- uvx things-mcp

Confirm that the server is configured:

codex mcp list

You can also configure it in the ChatGPT desktop app:

1. Open Settings → MCP servers
2. Select Add server