hald/things-mcp

解決する課題

macOSでThings 3を使用してタスクを管理している場合、ToDoアプリとAIアシスタントとのチャットの間を行き来する必要があることがよくあります。このサーバーは、ChatGPT、Claude、Codex、その他のMCPクライアントが会話から直接Thingsのデータを読み書きできるようにすることで、そのギャップを埋めます。チャットウィンドウを離れることなく、今日のタスクの要約を依頼したり、チェックリスト付きの新しいToDoを作成したり、古いアイテムを検索したりできます。

仕組み

このサーバーはローカルのモデルコンテキストプロトコル (MCP) サーバーです。公式のThings URLスキーム（およびURLスキームで不十分な操作のためのAppleScript）を使用してThings 3と通信します。インストール（uvx things-mcp またはワンクリックパッケージ経由）してClaude DesktopやChatGPT WorkなどのMCPクライアントに接続すると、アシスタントは一連のツールにアクセスできるようになります。これらのツールには、すべての標準リスト（インボックス、今日、予定、その他）の読み取り、ToDoやプロジェクトの作成と更新、タグの管理、高度な検索が含まれます。サーバーはMac上で動作するため、Things 3がインストールされており、「Things URLを有効にする」がオンになっている環境でのみ機能します。

対象ユーザー

macOSでThings 3を使用し、ChatGPT、Claude、CodexなどのAIアシスタントを日常的に利用している個人向けです。毎回Thingsアプリを開く代わりに、自然言語でリクエストを入力して個人のタスクを管理したい人に最適です。チームコラボレーションツールではなく、単一ユーザーのローカルタスクデータベースに接続します。

主な特徴

• すべての主要なThingsリストへのアクセス：インボックス、今日、予定、いつか、ログブック、ゴミ箱など
• チャットから直接ToDo、プロジェクト、エリアを作成、更新、管理
• タグ操作（未使用のタグを特定して整理するための使用状況レポートを含む）
• ステータス、日付、タグ、プロジェクト、作成時間によるフィルタリングを備えた高度な検索
• ネストされたデータのサポート（エリアにはプロジェクトが含まれ、プロジェクトにはToDoや見出しが含まれる）
• 「いつか」プロジェクトは「今日」「予定」「いつでも」ビューから自動的に除外され、ThingsのUI動作と一致
• 読み取りツール用のページネーションと構造化されたコンテンツにより、生のデータへのプログラム的なアクセスが可能
• 一括操作：複数のToDoを一度に更新（再スケジュール、タグ設定、完了マークなど）
• リモートアクセス用のオプションのHTTPトランスポート（デフォルトはstdio）