这是一台MCP（模型上下文协议）服务器，提供与macOS上的Things3全面集成。该服务器使AI助手和其他MCP客户端能够通过25个专用工具与Things3交互，提供完整的任务管理功能，具备智能纠错和自动标签创建功能。

特色

• 完成Things3集成：25个涵盖Things3各个方面的工具
• 待办事项管理：创建、读取、更新、删除、完成和未完成任务
• 项目与区域管理：完整的项目生命周期支持，包含区域组织和删除
• 标签系统：支持层级标签，支持创建、删除和批量标签操作
• 批量操作：高效地一次移动或更新多个项目
• 自动标签创建：在TODO/项目操作中引用标签时会自动创建
• 错误更正：自动修复常见问题（日期冲突、缺少标题）
• 日志本搜索：带日期范围筛选的已完成项目
• 性能优化：连接池和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: