Things App

🚀 事項 MCP サーバー

この モデルコンテキストプロトコル (MCP) サーバーを使用すると、Claude デスクトップ版を使って Things アプリ のタスク管理データとやり取りすることができます。Claude にタスクの作成、プロジェクトの分析、優先度の管理などを依頼することができます。

このサーバーは Things.py ライブラリと Things URL スキーム を利用しています。

✨ 主な機能

• すべての主要な Things リスト（受信箱、今日、近日など）にアクセス
• プロジェクトとドメインの管理
• タグ操作
• 高度な検索機能
• 最近のプロジェクトの追跡
• チェックリストを含む詳細なタスク情報
• 入れ子データ（ドメイン内のプロジェクト、プロジェクト内のタスク）のサポート

📦 インストール

Claude デスクトップ版用のインストール手順

1. 前提条件

• Python 3.12 以上
• Claude デスクトップ版
• Things 3 （設定 -> 全般で「Things URLs を有効にする」をオンにする必要があります）

2. まだインストールされていない場合は、uv をインストールします。

curl -LsSf https://astral.sh/uv/install.sh | sh

ターミナルを再起動します。

3. このリポジトリをクローンします。

git clone https://github.com/hald/things-mcp

4. 必要な Python パッケージをインストールします。

cd things-mcp
uv venv
uv pip install -r pyproject.toml

5. Claude デスクトップ版の設定ファイルを編集します。

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

JSON 配列に以下の内容を追加します。

{
  "mcpEndpoints": [
    {
      "name": "Things",
      "url": "http://localhost:9001"
    }
  ]
}

💻 使用例

Claude デスクトップ版での使用例

Claude デスクトップ版でこのサーバーを使用する際のサンプル質問をいくつか紹介します。

• すべてのプロジェクトとタスクをリストする。
• 新しいタスクまたはプロジェクトを作成する。
• 期限日でタスクをフィルタリングする。
• 既存のタスクのステータスや属性を更新する。

ツールの使用例

クエリツール

• /items
  Things データベース内のすべてのプロジェクトとタスクを取得します。ページネーションによる追加データの読み込みがサポートされています。

作成ツール

• /items/create
  Things 内に新しいタスクまたはプロジェクトを作成します。

更新ツール

• /items/update
  既存のタスクまたはプロジェクトの属性とステータスを更新します。

ツールのパラメータ

クエリツール (/items)

作成ツール (/items/create)

更新ツール (/items/update)

💡 使用アドバイス

• 設定で Things データベースのログ記録を有効にすると、デバッグと監視がしやすくなります。

defaults write com.culturedcode.Things-MacOS developer-mode -bool true

• poetry run コマンドを使用してサーバーを実行すると、依存関係の環境を分離できます。

🔧 トラブルシューティング

このサーバーは以下のエラーの処理を含んでいます。

• 無効な UUID
• 必須パラメータの欠落
• Things データベースへのアクセスエラー
• データ形式エラー

すべてのエラーは記録され、説明付きのメッセージが返されます。Claude デスクトップ版の MCP ログを表示するには、ターミナルで以下のコマンドを実行します。

# 最後の 20 行のログをリアルタイムで追跡
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log