Сервер MCP (Model Context Protocol) обеспечивает полную интеграцию с Things3 на macOS. Этот сервер позволяет ИИ-помощникам и другим MCP-клиентам взаимодействовать с Вещей3 с помощью 25 специализированных инструментов, предлагая полные возможности управления задачами с интеллектуальным исправлением ошибок и автоматическим созданием тегов.

Особенности

• Интеграция целых вещей3: 25 инструментов, охватывающих все аспекты вещей3 TODO Management: создавать, читать, обновлять, удалять, выполнять и не выполнять задачи Управление проектами и зонами: Полная поддержка жизненного цикла проекта с организацией и удалением области Tag System: поддержка иерархических тегов с помощью операций создания, удаления и массового тега -Народные операции: Эффективное перемещение или обновление нескольких элементов одновременно ** Автоматическое создание тегов** Теги автоматически создаются при упоминании в операциях TODO/проекта. ** Исправление ошибок**: Автоматическое исправление общих проблем (конфликты дат, недостающие названия) Logbook Search: Поиск завершенных элементов с фильтрацией диапазона дат Оптимизированная производительность: объединение соединений и оптимизация AppleScript

Требования

macOS (Things3 только для macOS) Node.js >= 16.0.0

Things3 MCP Server

An MCP (Model Context Protocol) server that provides comprehensive integration with Things3 on macOS. This server enables AI assistants and other MCP clients to interact with Things3 through 25 specialized tools, offering complete task management capabilities with intelligent error correction and automatic tag creation.

Features

• Complete Things3 Integration: 25 tools covering all aspects of Things3
• TODO Management: Create, read, update, delete, complete, and uncomplete tasks
• Project & Area Management: Full project lifecycle support with area organization and deletion
• Tag System: Hierarchical tag support with creation, deletion, and bulk tag operations
• Bulk Operations: Efficiently move or update multiple items at once
• Automatic Tag Creation: Tags are automatically created when referenced in TODO/project operations
• Error Correction: Automatic fixing of common issues (date conflicts, missing titles)
• Logbook Search: Search completed items with date range filtering
• Performance Optimized: Connection pooling and AppleScript optimization

Requirements

• macOS (Things3 is macOS-only)
• Node.js >= 16.0.0
• Things3 app installed
• AppleScript access enabled in System Settings

Installation

Quick Start (Recommended)

You can use the server without any installation:

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

Install from npm

npm install -g things3-mcp

Then add to your MCP client configuration:

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

Install from Source

# Clone the repository
git clone https://github.com/urbanogardun/things3-mcp.git
cd things3-mcp

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Environment Variables

For update operations (modify, complete, delete), you need to set your Things3 authorization token:

export THINGS3_AUTH_TOKEN="your_auth_token_here"

To find your authorization token:

1. Open Things3
2. Go to Settings → General
3. Click “Enable Things URLs”
4. Click “Manage”
5. Copy the authorization token value

You can also create a .env file (see .env.example).

For Claude Desktop

1. Open Claude Desktop configuration:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the Things3 MCP server using one of these methods: