MCP (Model Context Protocol) 서버는 macOS의 Things3와 종합적인 통합을 제공합니다. 이 서버는 AI 조수 및 기타 MCP 클라이언트가 Things3를 통해 25 전문 도구와 상호 작용하여 지능형 오류 보정 및 자동 태그 생성과 완벽한 작업 관리 기능을 제공합니다.

특징

• **Complete Things3 통합 ** : 25 가지의 모든 측면을 다루는 도구3
• TODO Management: 생성, 읽기, 업데이트, 삭제, 완료, 불완전한 작업 -Project & Area Management: 전체 프로젝트 라이프사이클 지원
• Tag System: Hierarchical 태그 생성, 삭제 및 대량 태그 작업 지원
• **Bulk 운영 **: 한 번에 여러 항목을 효율적으로 이동하거나 업데이트
• ** 자동 태그 생성**: 태그는 TODO / Project 작업에 따라 자동으로 생성됩니다. -Error Correction: 일반적인 문제의 자동 고정 (일부 충돌, 누락된 제목) -Logbook Search: 날짜 범위 필터링으로 완료된 아이템 검색
• Performance Optimized: 연결 풀 및 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: