mh-things-mac
by mohdalhashemi98-hue
Coding Agents & IDEsBrief
Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list.
Description
What This Skill Does
Connects OpenClaw to Things 3 on macOS using the `things` CLI. Reads inbox, today, upcoming, projects, areas, and tags directly from the local Things database. Adds and updates todos via the Things URL scheme.
Lets you manage Things 3 tasks from the command line or via AI without switching apps or using the GUI.
When to Use It
- Add a task to Things inbox while working in the terminal
- List today's tasks without opening Things
- Search existing todos by keyword
- Move a todo into a specific project and heading
- Mark a task complete or canceled from a script
Example Workflow
User asks: Add 'Book dentist appointment' to my Health project with the tag 'phone'
- 1
Run
things projectsto confirm the project name exists - 2
Run
things add "Book dentist appointment" --list "Health" --tags "phone" - 3
Optionally run
things search "Book dentist" --limit 3to verify the task was created
Todo 'Book dentist appointment' added to the Health project with tag 'phone'
Requirements
- THINGS_AUTH_TOKEN environment variable (required only for update/modify operations, obtained from Things 3 app settings)
- Full Disk Access granted to Terminal or OpenClaw.app (macOS system preference, required for database reads)
Installation
clawhub install mohdalhashemi98-hue/mh-things-macRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.