Things MCP

🚀 Things MCP Server

このプロジェクトは、Model Context Protocol (MCP) を使用して、Claude Code、Claude Desktop、Cursor などのAIアシスタントから直接 Things.app のタスクを制御することができます。

🚀 クイックスタート

1. Thingsの認証トークンを取得する

既存のタスクを更新するには、認証トークンが必要です。

1. macOSで Things.app を開きます。
2. Things → 環境設定 → 全般 に移動します。
3. 「ThingsのURLを有効にする」 をチェックします。
4. 表示される認証トークンをコピーします。

2. AIアシスタントを設定する

{
  "mcpServers": {
    "things": {
      "command": "npx",
      "args": ["@wenbopan/things-mcp"],
      "env": {
        "THINGS_AUTH_TOKEN": "your-token-here"
      }
    }
  }
}

{
  "things": {
    "command": "npx",
    "args": ["@wenbopan/things-mcp"],
    "env": {
      "THINGS_AUTH_TOKEN": "your-token-here"
    }
  }
}

3. AIアシスタントを再起動する

設定を完了したら、AIアシスタントを再起動してMCPサーバーを読み込みます。

✨ 主な機能

このMCPサーバーにより、AIアシスタントはmacOS上のThings.appのタスクとやり取りすることができます。以下の操作が可能です。

• 新規作成：新しいタスクやプロジェクトを作成します。
• 更新：既存の項目を更新します。
• 閲覧：詳細な要約付きでタスクデータベースを表示します。
• スケジュール設定：特定の日付にタスクをスケジュール設定します。
• 整理：エリア、タグ、期限でタスクを整理します。

💻 使用例

基本的な使用法

日々の計画

「今日のタスクを表示し、新しいマーケティングキャンペーンのプロジェクトを作成し、調査、デザイン、コンテンツ作成の初期タスクを追加してください。」

プロジェクト管理

「モバイルアプリプロジェクトを更新して、デザインレビューとテストタスクを追加し、デザインレビューを来週の月曜日にスケジュール設定してください。」

タスク整理

「予定のないすべてのショッピングタスクを「個人」エリアに移動し、「週末」のタグを付けてください。」

進捗追跡

「すべてのアクティブなプロジェクトの期限と完了状況の要約を表示してください。」

即時登録

「歯医者に電話するタスクを作成し、明日にスケジュール設定し、週末までに完了するように期限を設定してください。」

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

🔧 貢献の方法

イシューとプルリクエストは大歓迎です！提出する前にすべてのテストが通過することを確認してください。