Things Safe MCP

Things 3 向けの非公式 MCP サーバーで、Cultured Code が安全であると文書化している統合メソッドのみを使用します：

• 読み取りと通常のタスク編集には AppleScript を使用します。

• チェックリスト編集には Things URL scheme を使用します。

Things のデータベース、アプリのサポートファイル、Things Cloud の認証情報を読み書きすることは一切ありません。macOS 専用で、Things 3 が必要です。

インストール

uv をインストールし、サーバーを MCP クライアントに登録します。Codex の場合：

codex mcp add things -- uvx --from git+https://github.com/jasongibby/things-safe-mcp things-safe-mcp

他の stdio MCP クライアントの場合は、次を使用します：

{
  "mcpServers": {
    "things": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jasongibby/things-safe-mcp",
        "things-safe-mcp"
      ]
    }
  }
}

最初のリクエストの前に Things を一度起動してください。macOS は、MCP ホストが Things を自動化する許可を求めます。

チェックリストトークン

チェックリストの編集にのみ、Things URL scheme の認証トークンが必要です。Things で Settings → General → Enable Things URLs → Manage を開いてトークンを生成し、MCP クライアントの安全な環境設定を通じてサーバーに THINGS_AUTH_TOKEN として提供してください。トークンをコミットしたり共有したりしないでください。

他のすべての操作はトークンなしで動作します。

ツール

• Inbox、Today、Upcoming、Anytime、Someday、プロジェクト、プロジェクトタスク、および直接タグ付けされたタスクを読み取ります。

• タスクのタイトルとメモを検索します。

• タスクを作成します。

• タイトル、メモ、タグ、ステータス、スケジュール、プロジェクト割り当てを編集します。空のプロジェクト ID を渡すと、タスクをプロジェクトから切り離します。

• チェックリスト項目を置換、追加、または先頭に挿入します。

安全性とプライバシー

Cultured Code は、AppleScript と Things URL scheme を安全な接続方法として挙げています。このサーバーは、ユーザー入力を AppleScript ソースに埋め込むのではなく、プロセス引数として渡します。

MCP クライアントと AI プロバイダーは、サーバーが返すタスクデータを閲覧できます。使用前に、それらのプライバシーポリシーを確認してください。このプロジェクトは Cultured Code とは提携関係になく、その承認も受けていません。

• サードパーティ AI ツールと Things

• Things AppleScript コマンド

• Things URL Scheme

開発

uv sync
uv run python -m unittest discover -s tests -v

テストはすべての外部プロセスをモックし、Things にアクセスすることはありません。

ライセンス

MIT