things-mac

The skill uses the things3-cli binary under the hood, which operates in two modes:Read mode — Queries your local ThingsData-* SQLite database directly to return inbox items, today's tasks, upcoming tasks, projects, areas, tags, and search results.Write mode — Constructs Things URL scheme calls to add or update todos. Supports titles, notes, deadlines, tags, checklists, project/heading placement, and status changes (complete or cancel).Use --dry-run to preview any write command as a URL before it executes, so you can verify what will happen before committing a change.

Read Your Inbox & Lists — Fetch inbox, today, upcoming, and trash views directly from the Things database.Full-Text Search — Search all your tasks by keyword and retrieve results with UUIDs for further operations.Add Todos with Rich Metadata — Create tasks with notes, deadlines, due dates, tags, checklists, and target project or area headings.Update Existing Tasks — Modify title, notes (replace, append, or prepend), tags, list placement, and completion status using a task's UUID.Dry-Run Preview — Preview any write operation as a Things URL before execution — no accidental changes.Browse Projects, Areas & Tags — List all your organizational structures for context-aware task placement.STDIN Support — Pipe multi-line content directly into a new task (first line becomes the title, remaining lines become notes).

macOS — This skill is macOS-only and requires Things 3 to be installed and have been launched at least once so its database exists.Full Disk Access — The calling application (OpenClaw.app for gateway use, or Terminal for manual runs) must be granted Full Disk Access in System Settings → Privacy & Security to allow database reads.Things Auth Token (optional) — Required only for update operations (modifying existing tasks). Obtain it from Things 3 → Settings → General → Enable Things URLs → Auth Token. Set as THINGS_AUTH_TOKEN or pass via --auth-token. Without it, read operations and adding new tasks still work.Custom DB Path (optional) — If your Things database is in a non-default location, set the THINGSDB environment variable or pass --db to point at your ThingsData-* folder.

Quick Task Capture — Tell OpenClaw "Add a task to call the dentist, tag it health and phone" and it lands in Things instantly.Morning Briefing — Ask OpenClaw what's on your plate today or upcoming, and get a summary pulled straight from Things 3.Project Planning — Add multiple todos into a specific project and heading in one conversation, complete with checklists and deadlines.Task Updates — Search for a task by keyword, then update its notes, move it to a different list, or mark it complete — all without opening the Things app.