
Things Mac
- 9 installs
- 33 repo stars
- Updated April 26, 2026
- bighardperson/computer-science-skills-collection
things-mac is a Claude skill that manages Things 3 on macOS via the things CLI, reading the local database and adding or updating todos through the URL scheme.
About
This skill manages Things 3 on macOS through the things CLI, reading the local Things database (inbox, today, upcoming, search, projects, areas, tags) and adding or updating todos and projects via the Things URL scheme. A developer uses it when they want an agent to capture tasks into Things or inspect their existing task lists. It matters because it supports a safe dry-run preview and standard task fields like notes, deadlines, tags and checklists. It is macOS-only.
- Reads the local Things 3 database (inbox, today, upcoming, search, projects, areas, tags)
- Adds and updates todos and projects through the Things URL scheme via the things CLI
- Supports --dry-run preview and macOS-only Full Disk Access for DB reads
Things Mac by the numbers
- 9 all-time installs (skills.sh)
- Ranked #2,218 of 3,280 Productivity & Planning skills by installs in the Skillselion catalog
- Data as of Jul 30, 2026 (Skillselion catalog sync)
things-mac capabilities & compatibility
Free CLI; requires the Things 3 app on macOS
- Capabilities
- task management · project management · task capture
- Use cases
- project management
- Platforms
- macOS
- Runs
- Runs locally
- Pricing
- Free
What things-mac says it does
Use `things` to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.
Prefer safe preview: `things --dry-run add "Title"`
macOS-only.
npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill things-macAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 9 |
|---|---|
| repo stars | ★ 33 |
| Last updated | April 26, 2026 |
| Repository | bighardperson/computer-science-skills-collection ↗ |
What it does
Manage Things 3 tasks and projects on macOS by reading the local DB and writing todos via the CLI.
Who is it for?
macOS users who want an agent to capture or list Things 3 tasks and projects
Skip if: Non-macOS platforms; the skill is macOS-only
When should I use this skill?
The user asks to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags
What you get
Tasks captured into or listed out of Things 3 without leaving the terminal
- Created or updated Things 3 todos and projects
- Task list output from the local database
By the numbers
- 7 read commands (inbox, today, upcoming, search, projects, areas, tags)
Files
Things 3 CLI
Use things to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.
Setup
- Install:
GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest - If DB reads fail: grant Full Disk Access to the calling app.
- Optional: set
THINGSDBor pass--dbto point at yourThingsData-*folder. - Optional: set
THINGS_AUTH_TOKENto avoid passing--auth-tokenfor update ops.
Read-only (DB)
things inbox --limit 50things todaythings upcomingthings search "query"things projects/things areas/things tags
Write (URL scheme)
- Prefer safe preview:
things --dry-run add "Title" - Add:
things add "Title" --notes "..." --when today --deadline 2026-01-02 - With tags:
things add "Call dentist" --tags "health,phone" - Checklist:
things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"
Modify (needs auth token)
- Get ID:
things search "milk" --limit 5 - Title:
things update --id <UUID> --auth-token <TOKEN> "New title" - Complete:
things update --id <UUID> --auth-token <TOKEN> --completed
Notes
- macOS-only.
--dry-runprints the URL and does not open Things.
{
"name": "Things任务",
"installedAt": 1776152049804,
"source": "marketplace",
"iconSource": "things-mac",
"version": "1.0.0"
}Related skills
FAQ
What platforms does things-mac support?
macOS only. The skill notes it is macOS-only and reads the local Things database.
How do writes work?
Adds and updates go through the Things URL scheme; the skill recommends a --dry-run preview first, and modify operations need a Things auth token.