MacOS で Thing3 との包括的な統合を実現する MCP (Model Context Protocol) サーバー。 このサーバーでは、AI アシスタントやその他の MCP クライアントが、インテリジェントなエラー修正と自動タグ作成で、完全なタスク管理機能を提供します。

##特徴

• Complete Things3インテグレーション:Things3のすべての側面をカバーする25ツール
• TODO Management: 作成、読み込み、更新、削除、完了、および未完了のタスク
• プロジェクト及び区域管理: 地域組織と削除によるフルプロジェクトライフサイクルのサポート
• タグシステム:作成、削除、およびバルクタグ操作による階層タグのサポート
• バルク操作: 複数の項目を一度に効率的に移動または更新する
• 自動札の作成: 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: