things-mac

Read and update Things 3 tasks via local database and URL scheme.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/JOHNNYWHITEMIKE/openclaw --skill things-mac-johnnywhitemike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: things-mac
Source: https://github.com/JOHNNYWHITEMIKE/openclaw/tree/main/openclaw/.openclaw/openclaw/skills/things-mac
Command: npx skills add https://github.com/JOHNNYWHITEMIKE/openclaw --skill things-mac-johnnywhitemike

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires things.

What problem does it solve?

This Skill removes the friction of switching between OpenClaw and Things when you need to view, search, or update your Things 3 tasks quickly on macOS.

Core Features & Use Cases

  • Inbox/Today/Upcoming viewing: Pull your Things lists (inbox, today, upcoming) directly from the local database.
  • Search and discovery: Search tasks and browse projects, areas, and tags to find the right item.
  • Add and update via URL scheme: Create todos and update details (notes, deadlines, lists, headings, tags, checklist items) using the Things URL scheme.

Use case: Ask OpenClaw to add a todo to a specific project area with notes and tags, then immediately list today’s tasks to confirm what was created.

Quick Start

Tell OpenClaw: add a todo titled "Call dentist" with notes "Next available appointment" to the list "Health" and tags "health,phone".

Frequently Asked Questions about things-mac

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Things 3 tasks from the command line on macOS?

To add a todo via the Things URL scheme, provide a title along with optional parameters like notes, list, headings, and tags. This allows natural-language task creation directly from your command line interface without opening the app.

Can I search and retrieve Things 3 projects, areas, and tags using a CLI?

Yes, you can retrieve Things 3 projects, areas, and tags by reading the local Things database directly. This supports quick search and discovery of specific tasks and project structures from your terminal.

Do I need the things3-cli binary and macOS to use Things URL scheme updates?

Yes, macOS support and the things3-cli binary are required to read the local database and execute Things URL scheme updates. Optional configurations like THINGSDB and THINGS_AUTH_TOKEN support authenticated update operations.

What are the limitations of updating Things 3 todos via the URL scheme?

Updates via the Things URL scheme are limited to actions supported by the protocol, such as modifying notes, deadlines, lists, headings, tags, and checklist items, and require proper authentication tokens for write operations.