Setup & Installation
openclaw skills install @mohdalhashemi98-hue/mh-things-mac
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install mh-things-mac
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
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Add 'Book dentist appointment' to my Health project with the tag 'phone'
AGENT
- 1Run `things projects` to confirm the project name exists
- 2Run `things add "Book dentist appointment" --list "Health" --tags "phone"`
- 3Optionally run `things search "Book dentist" --limit 3` to verify the task was created
OUTPUT
Todo 'Book dentist appointment' added to the Health project with tag 'phone'
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
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)