How do I install the Things Mac skill?

Run npx skillmds@latest add ahang1598/things-mac in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Things Mac safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Things Mac?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Things Mac free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Things Mac?

ahang1598 (@ahang1598) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Things Mac by ahang1598 — Agent Skill

Name: Things Mac
Rating: 4.2 (5 reviews)
Author: ahang1598

Things Mac

Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks CodeBuddy Code to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.

ahang1598 Updated Sep 9, 2026 9 repo stars

File contents

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 THINGSDB or pass --db to point at your ThingsData-* folder.
Optional: set THINGS_AUTH_TOKEN to avoid passing --auth-token for update ops.

Read-only (DB)

things inbox --limit 50
things today
things upcoming
things 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-run prints the URL and does not open Things.

Frequently asked questions