Things MCP サーバー

このモデルコンテキストプロトコル（MCP）サーバーを使用すると、Claude Desktop を使ってThings アプリ内のタスク管理データを操作できます。Claude にタスクの作成、プロジェクトの分析、優先順位の管理などを依頼できます。

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

特徴

すべての主要な Things リスト (受信トレイ、今日、今後の予定など) へのアクセス
プロジェクトおよびエリア管理
タグ操作
高度な検索機能
最近のアイテムの追跡
チェックリストを含む詳細なアイテム情報
ネストされたデータのサポート（エリア内のプロジェクト、プロジェクト内の ToDo）

Related MCP server: Things MCP Server

インストール（Claude Desktop の場合）

前提条件

Python 3.12以上
クロードデスクトップ
Things 3（設定 -> 一般で「Things URL を有効にする」をオンにする必要があります）

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

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

その後、ターミナルを再起動してください。

このリポジトリをクローンします:

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

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

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

Claude Desktop 構成ファイルを編集します。

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

構成ファイルの mcpServers キーに Things サーバーを追加します (これらのファイルをインストールしたフォルダーへのパスを必ず更新してください)。

{
    "mcpServers": {
        "things": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
                "run",
                "things_server.py"
            ]
        }
    }
}

Claude デスクトップアプリを再起動します。

Claude Desktop での使用例

「今日のToDoリストには何がある？」
「来週のビーチでの休暇に備えて荷造りの ToDo リストを作成し、荷造りチェックリストも含めます。」
「アイゼンハワーマトリックスを使用して現在の ToDo を評価します。」
「Things を使用して GTD スタイルの週次レビューを実施するのを手伝ってください。」

ヒント

Claude で、Things の使用方法や、エリア、プロジェクト、タグなどの整理方法を説明するカスタム手順を含むプロジェクトを作成します。新しいタスクを作成するときに含めてほしい情報を Claude に伝えます (たとえば、タスクの説明に関連する詳細を含めるように依頼すると役立つ場合があります)。
Claude にカレンダーへのアクセスを許可する別の MCP サーバーを追加してみてください。これにより、Claude にカレンダーの特定のタスクの時間をブロックしたり、今後のカレンダーイベント（例: 会議の準備）から ToDo を作成したりといった操作を依頼できるようになります。

利用可能なツール

リストビュー

get-inbox - 受信トレイからToDoを取得する
get-today - 今日が期限のToDoを取得する
get-upcoming - 今後のToDoを取得する
get-anytime - いつでもリストからToDoを取得する
get-someday - Someday リストから ToDo を取得する
get-logbook - 完了したToDoを取得する
get-trash - ゴミ箱に入れられたToDoを取得する

基本操作

get-todos - オプションでプロジェクト別にフィルタリングしたToDoを取得
get-projects - すべてのプロジェクトを取得する
get-areas - すべてのエリアを取得する

タグ操作

get-tags - すべてのタグを取得する
get-tagged-items - 特定のタグが付いたアイテムを取得する

捜索活動

search-todos - タイトル/メモによる簡単な検索
search-advanced - 複数のフィルターを使った高度な検索

時間ベースの操作

get-recent - 最近作成されたアイテムを取得する

ツールパラメータ

やるべきことを取得する

project_uuid (オプション) - プロジェクトごとにToDoをフィルタリングします
include_items (オプション、デフォルト: true) - チェックリスト項目を含める

プロジェクトを取得 / エリアを取得 / タグを取得

include_items (オプション、デフォルト: false) - 含まれるアイテムを含める

詳細検索

status - ステータス（未完了/完了/キャンセル）でフィルタリング
start_date - 開始日（YYYY-MM-DD）でフィルタリング
deadline - 締め切り（YYYY-MM-DD）でフィルタリング
tag - タグでフィルタリング
area - エリアUUIDでフィルタリング
type - アイテムの種類（ToDo/プロジェクト/見出し）でフィルタリング

トラブルシューティング

サーバーには次のエラー処理が含まれています:

無効なUUID
必要なパラメータが不足しています
データベースアクセスエラー
データフォーマットエラー

すべてのエラーはログに記録され、説明メッセージとともに返されます。Claude Desktop の MCP ログを確認するには、ターミナルで次のコマンドを実行してください。

# Follow logs in real-time
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

Things MCP Server