| name | things |
| description | Add and manage actionable items in Things (macOS) via URL scheme. Add to-dos, projects, update tasks, show lists, search. Use when user asks to add tasks to Things, create to-dos, Things integration, or /things. |
Things Skill
Add and manage actionable items in Things 3 for Mac using the Things URL Scheme. Requires macOS with Things 3.
Usage
python3 _scripts/things.py add "Buy milk"
python3 _scripts/things.py add "Call dentist" --when tomorrow --tags Errand
python3 _scripts/things.py project "Vacation" --area Family --todos "Book flights" "Pack bags"
python3 _scripts/things.py show
python3 _scripts/things.py search "meeting"
Add Options
--when, -w — today, tomorrow, evening, anytime, someday, or date (e.g. 2026-02-25)
--list, -l — Project or area name
--notes, -n — Notes
--tags, -t — Comma-separated tags
--deadline, -d — Deadline date
Update (requires THINGS_AUTH_TOKEN in .env)
Get token from Things → Settings → General → Things URLs → Manage.
python3 _scripts/things.py update <todo-id> --when today
python3 _scripts/things.py update <todo-id> --completed true
Output
Opens Things app via URL scheme. No file output.